Hermes Agent Apple Health works through a community plugin called Apple Health Data (catalog name apple-health-analyzer): once you opt in, your Hermes agent can read selected daily numbers, such as steps, sleep, workouts, heart rate and HRV, from a Mac app that already holds your imported Apple Health data.
📺 Watch: 10 Hermes Agent Systems I Actually Use Every Day! 🤯
🔥 Get the Agent OS as a free bonus: AI Profit Boardroom members get the full Agent OS zip, prompt libraries, daily tutorials and weekly live coaching calls. → Get inside
It landed in the official Hermes plugin catalog this week and shows up in the release notes for the 15 November 2026 canary build. This guide covers what it reads, what it refuses to read, how the privacy switches work and how to set it up without leaking a token.
Julian Goldie walks members through new Hermes plugins like this one, step by step, inside the AI Profit Boardroom. If you would rather plan your agent setup with his team first, book a free AI strategy session.
What the Apple Health Data plugin is
The catalog entry is maintained by krumjahn, sits in the community tier and is labelled version 0.1.0. Nous Research did not build it.
The plugin catalog docs explain the three tiers. Official means maintained by NousResearch, verified means checked to come from the company whose product it integrates, and community covers everything else.
Every catalog entry is still merged by a human reviewer and pinned to one exact commit. A plugin author pushing new code does not change what you install until another reviewed pull request moves the pin.
The plugin needs Hermes 0.23.1 or later and runs on macOS only. The stable v0.23.1 release shipped on 10 November 2026.
Where the data actually comes from
This is the part most people get wrong. The plugin does not open your Health export file and it does not talk to HealthKit.
It reads from a separate Mac app called Health Data AI Analyzer, through that app's Local API on your own machine. The app is the piece that imports your Apple Health XML file. The plugin only asks the app for one day's summary.
Apple's own Health sharing guide covers the first step: on iPhone you tap Export All Health Data to get everything in XML format.
So the chain is iPhone Health, then an export, then the Mac app's dataset, then the plugin, then your agent. If the dataset is a month old, the agent sees month-old numbers. The adapter never syncs anything itself.
📺 Watch: Hermes3D Is INSANE: AI Agents Now Have a 3D Office
What Hermes Agent Apple Health can read
The plugin adds exactly two tools. The table below follows the plugin README at the reviewed commit.
| Tool or group | What comes back | Unit |
|---|---|---|
| apple_health_analyzer_status | App name and version, and whether a dataset is loaded. No health values and no token | None |
| steps | Daily step count with any seven-day baseline | Steps |
| sleep | Recorded sleep for the date | Hours |
| workouts | Workout duration for the date | Minutes |
| heart_rate | Recorded heart rate values | Beats per minute |
| hrv | Heart rate variability | Milliseconds (SDNN) |
The daily tool, apple_health_analyzer_daily_metrics, takes one explicit date in YYYY-MM-DD form and only the groups you ask for.
Missing values come back as null, not zero. If the app quietly falls back to a different day, the plugin withholds every value and reports date_unavailable instead of passing off the wrong day as yours.
It also leaves things out on purpose: narrative signals, recovery scores, workout types, sleep times and any metric you did not select.
The README is clear that these are recorded summaries, not diagnosis, treatment recommendations or medical advice. Treat the agent the same way. It can tidy your numbers into a weekly note. It cannot tell you what they mean for your body, and that conversation belongs with a qualified professional.
📺 Watch: Hermes AI Agents Just Went Portable
Privacy: what stays on your Mac and what doesn't
The connection between Hermes and the Mac app is local. The plugin only sends read-only GET requests to a fixed address, 127.0.0.1 on port 8765, with no setting to point it anywhere else.
But the README says plainly that this is not wholly local AI. Once a result reaches Hermes, it enters your conversation, it can be sent to whichever model provider you have configured, and it can stay in your chat history.
- Off by default. The switch named Allow health summaries in Hermes starts off and is separate from enabling the plugin. Until you turn it on, the plugin makes no requests at all, not even a status check.
- You flip it, not the agent. The README says the agent must not enable the setting for you.
- Nothing stored by the plugin. No health database, file writes, logging, analytics, background jobs or shell commands.
- No cloud calls of its own. It does not contact Apple, iCloud, the app's cloud service or any model API directly.
- Profile-wide access. Anyone who can run tools in that Hermes profile can ask for your summaries, so never enable it in a shared chat or a gateway other people message.
If you want the results to stay on the machine too, pair the plugin with a local model. Hermes lists LM Studio and custom endpoints such as Ollama in its provider docs, with a minimum context of 64,000 tokens.
How to set it up, step by step
- Update Hermes to 0.23.1 or later, on the same Mac that runs the app. A remote Mac, a VPS or a container is not supported.
- Make a private profile. Run hermes profile create health so this access never touches your work or team profiles. The profiles docs explain how each profile keeps its own config.
- Install the plugin with hermes plugins install apple-health-analyzer.
- Prepare the Mac app. In its Integrations screen, pick the dataset you want, for example Use Last Analysis, and turn on Local API yourself.
- Add the token safely. In Hermes Desktop, open Settings, then Plugins, and paste the app's token into the masked field called Mac app local API token. Never paste it into chat, a prompt or a screenshot.
- Opt in. Read the privacy notice, then switch on Allow health summaries in Hermes.
- Test it. Start a new conversation and ask the agent to check Apple Health Analyzer's connection. Then ask for steps and sleep on a date you know is in your dataset.
To revoke access, switch the setting off. Every call rechecks it, so there is no restart. Old conversations and provider copies are not erased, so clear those with each product's own retention controls.
For the bigger picture of where a plugin like this sits next to your other tools, read Julian's Agent OS guide. If you want a second pair of eyes on your profile and model choices, his team can map them out on a free AI strategy session.
The other route: reading the export file directly
A different community plugin, apple-health-mcp by davidmosiah, takes the opposite approach. It runs a local MCP server that parses your exported Apple Health zip file on disk, and it lists cycle tracking alongside workouts, steps, heart rate, HRV and sleep.
It needs Node.js 20 or later and has no live sync, so the data is only as fresh as your last export. Pick it if you don't want the Mac app. Pick Apple Health Data if you already use the app and want the agent to see one tightly limited daily summary.
Julian's roundup of the best Hermes Agent plugins covers the wider catalog if you are still choosing.
My verdict on Hermes Agent Apple Health
This is one of the more careful plugins in the catalog. Opt-in by default, a fixed local address, no files, no logs and an error instead of a wrong date are the right calls for personal data.
Use it on your own Mac, in a private profile, ideally with a local model, for jobs like a weekly activity log or a reminder that your dataset needs a fresh import. Skip it on any shared or team agent.
Before you pick a local model for it, compare the on-device scores on Goldie Bench. Members of the AI Profit Boardroom get the Agent OS and the setup trainings, and if you want a plan built around your own business, book a free AI strategy session.
FAQ
Does the plugin read my Apple Health export file?
No. It reads a daily summary from the Health Data AI Analyzer Mac app's Local API. The app imports your export, and the plugin never opens XML or zip files.
Is it an official Nous Research plugin?
No. It is a community-tier entry maintained by krumjahn. It was still reviewed by a human and pinned to one commit before it joined the catalog.
Which health numbers can my agent see?
Only the groups you request for one date: steps, sleep, workouts, heart rate and HRV, with any seven-day baseline. Recovery scores, sleep times and workout types are left out.
Does my data stay on my Mac?
The link to the app is local, but anything returned to Hermes can go to your configured model provider and stay in chat history. Use a private profile, and a local model if you want it all on the machine.
Can it give me health advice?
No. The plugin returns recorded numbers, and its README says they are not diagnosis, treatment recommendations or medical advice. Ask a qualified professional about what your numbers mean.
How do I switch it off?
Turn off Allow health summaries in Hermes. Every call rechecks the setting, so it takes effect at once. You can also disable or remove the plugin, or turn off Local API in the app.
Make a private profile, opt in yourself, keep the token in the masked field, and you have a safe Hermes Agent Apple Health setup.
