Hermes Agent Apple Health lets a busy business owner have their own Hermes agent read a few of their own recorded daily numbers, such as steps, sleep hours and workout minutes, from a Mac app, without copying anything by hand. It works through a new community plugin called Apple Health Data. Here’s what it reads, the privacy rules that matter for an owner, and the exact steps to set it up on your Mac.
Key takeaways
- Plugin: Apple Health Data, catalog name
apple-health-analyzer, community tier, by krumjahn. - Reads one date at a time from the Health Data AI Analyzer Mac app, not from your export file.
- Off by default: you flip the health switch, never the agent.
- macOS only, Hermes 0.23.1 or later, on the same Mac as the app.
- Want your business agents planned around it? Claim a free strategy session.
What the plugin is, in plain English
Apple Health Data is a small add-on for Hermes Agent, listed in the Hermes plugin catalog. krumjahn maintains it as a community entry at version 0.1.0; Nous Research reviewed the listing but did not write the code. The catalog addition appears in the 15 November 2026 canary release notes.
Its job is narrow. A separate Mac app, Health Data AI Analyzer, holds your imported Apple Health data. The plugin asks that app for one day’s numbers over a local connection and hands back only the ones you asked for.
| Apple Health Data at a glance | |
|---|---|
| Catalog name | apple-health-analyzer |
| Tier | Community (maintained by krumjahn) |
| Needs | Hermes 0.23.1+, macOS, the Mac app with Local API on |
| Reads | steps, sleep, workouts, heart_rate, hrv for one date |
| Connection | Read-only, to 127.0.0.1:8765 on the same Mac |
| Default | Off until you switch on health access yourself |
Is it worth it for a small business owner?
Only as a private, personal tool. Think of an owner who already has Hermes on a MacBook and would like last week’s own figures to land in a planning doc automatically.
- Good fit: a solo owner’s private Monday review that pulls last week’s recorded steps and sleep hours.
- Good fit: an owner who already uses the Mac app and is tired of copying figures across.
- Bad fit: anything involving staff or customer health data. It reads the dataset on your own Mac, nothing else.
- Bad fit: a business agent that lives on a server. Hermes and the app must sit on the same Mac.
Everything it hands back is a figure that was already recorded. The plugin README rules out diagnosis, treatment ideas and medical advice, so take any question about meaning to a qualified professional.
Want a private Hermes setup that never mixes your personal data with your business agents? Inside the AI Profit Boardroom you get the Agent OS — Hermes, OpenClaw, OpenCode, Claude and Codex in one place — plus step-by-step Hermes training and four live coaching calls a week.
Want a plan for your business first? Claim your free strategy session.
Join the AI Profit Boardroom →Claim Your Free SEO Strategy Session →
Step 1: Get Hermes and the Mac app ready
- Update Hermes to 0.23.1 or later. The catalog entry refuses older builds.
- Open the Mac app’s Integrations screen and choose the dataset the agent should read, for example Use Last Analysis.
- Turn on Local API yourself. The plugin will never start it for you.
- Make sure recent dates are in the dataset. The plugin never syncs, so start a fresh export on iPhone when it falls behind, using the Export All Health Data option described in Apple’s guide.
Step 2: Give it its own private profile
This is the most important step for a business. The plugin’s opt-in covers a whole Hermes profile, and the README warns that anyone who can use tools in that profile can ask for your summaries.
hermes profile create health
health plugins install apple-health-analyzerA separate Hermes profile keeps the plugin away from your team’s Slack or WhatsApp agent. Never add it to a profile that has a gateway other people message.
Step 3: Add the token the safe way
In Hermes Desktop, open Settings → Plugins, find the plugin and paste the Mac app’s token into the masked field called Mac app local API token. It is stored as APPLE_HEALTH_ANALYZER_TOKEN.
- Never paste the token into a chat, a prompt or a screenshot.
- The plugin never searches your Mac for token files.
- The app’s integration screen shows where its token lives.
Want this set up for you instead of doing it yourself? Claim your free strategy session →
Step 4: Switch on health access yourself
Enabling the plugin and allowing health reads are two different switches. The second, Allow health summaries in Hermes, starts off, and until you flip it the plugin sends nothing at all.
health config set plugins.entries.apple-health-analyzer.settings.allow_health_access true
health plugins enable apple-health-analyzerThe README says the agent must not enable this setting for you, so do it by hand.
Step 5: Test it with two questions
Start a new conversation in the health profile and ask:
- “Check Apple Health Analyzer’s connection.” This returns the app version and whether a dataset is loaded, with no health values.
- “Show my steps and sleep for 2026-11-10 from Apple Health Analyzer.” Use a date you know is in your dataset.
Sleep comes back in hours, workouts in minutes, heart rate in beats per minute and HRV in milliseconds. Missing values come back as null, not zero. If the date isn’t in the dataset, you get date_unavailable and no numbers at all, rather than a different day passed off as yours.
Keeping your numbers private
The link between Hermes and the Mac app is local. The chat around it is not. Per the README, anything returned can be passed to the AI provider your profile uses and stored in your Hermes history, so the plugin alone does not make your setup fully local.
- Pick a local model for the health profile, such as LM Studio or an Ollama endpoint from the Hermes providers list, with at least 64,000 tokens of context.
- Switch health access off at any time. Every call rechecks the setting, so no restart is needed.
- Clear old health chats with your provider’s own retention controls. Switching off doesn’t erase them.
Prefer to skip the Mac app? A different community plugin, apple-health-mcp, reads your exported zip file through a local MCP server instead. It needs Node.js 20 or later, and it also has no live sync.
My verdict
For a business owner, this is a personal tool, not a business system. Keep it in a private profile on your own Mac, use a local model if you can, flip the switch yourself, and never let it near a team agent. Its consent switch is strict, and the Hermes catalog only installs the exact commit a reviewer read. Set up that way, Hermes Agent Apple Health is a safe, small convenience for owners who already use the Mac app.
About Julian Goldie
I’m Julian Goldie — founder of Goldie Agency and the AI Profit Boardroom. I test new AI agents almost every day for 432K+ YouTube subscribers and run Hermes, OpenClaw, OpenCode, Claude and Codex side by side in my own Agent OS. Claim your free strategy session or join the AI Profit Boardroom.
Want another angle? Read the AI Profit Boardroom guide to Hermes Agent Apple Health.
FAQ: hermes agent apple health
What does the Hermes Agent Apple Health plugin read?
Steps, sleep, workouts, heart rate and HRV for one date you name, from the Health Data AI Analyzer Mac app. Nothing else is returned.
Does it read my Apple Health export file?
No. The Mac app imports your export. The plugin only asks the app for a daily summary over a local connection.
Who makes the Apple Health Data plugin?
A community developer, krumjahn. It sits in the community tier of the Hermes catalog, pinned to a reviewed commit, rather than the official tier.
Can I use it for my staff or customers?
No. It reads the dataset on your own Mac for whoever controls that Hermes profile. Keep it personal and private.
Does my data leave my Mac?
The link to the app is local, but results that reach Hermes can go to your model provider and chat history. A local model keeps them on the Mac.
Will it give me health advice?
No. It passes back figures that were already recorded. Questions about what they mean belong with a qualified professional.
Ready to put Hermes to work in your business? Join the AI Profit Boardroom for the Agent OS, setup training and daily updates.
Or claim your free strategy session and we’ll map out your setup.
Starting from zero? Get the free AI course and community.
Join the AI Profit Boardroom →Claim Your Free SEO Strategy Session →Get the FREE AI Course + Community →
Related reading
Last updated November 2026. This page is a living guide to hermes agent apple health — the facts here move fast and it is updated as they do.
