Hermes agent apple health connects five ways right now, and each route moves your data from the Health app to a place the agent can read: a Mac app, an exported zip, a receiver you host, or an encrypted sync app.
Four of the routes are community plugins in the Hermes plugin catalog. The fifth is an iPhone app that ships its own skills package.
Below is the comparison, then the exact install commands and setup order for each route, then the gotchas that apply to all of them.
If you want my team to look over your agent stack before you start, book a free SEO strategy session.
The Five Routes At A Glance
| Route | Install | Data source | Host | Status |
|---|---|---|---|---|
| apple-health-analyzer | hermes plugins install apple-health-analyzer | Health Data AI Analyzer Mac app, Local API on 127.0.0.1:8765 | Same Mac, macOS only | Catalog, community (krumjahn) |
| apple-health-mcp | hermes plugins install davidmosiah/apple-health-mcp/agent-plugin --no-enable | Your export.zip, parsed by a local MCP server | Any box with Node.js 20+ | Catalog, community (davidmosiah) |
| healthrelay | hermes plugins install healthrelay | SQLite database of a HealthRelay receiver you host | Your own machine | Catalog, community (mwdearing) |
| health-insights | hermes plugins install health-insights + a pipx CLI | The same HealthRelay receiver database | Your own machine | Catalog, community (mwdearing) |
| Health Sync for AI Agents | App Store app + its Agent Skills package | iPhone app, end-to-end encrypted sync | iPhone plus your agent | Third-party, not in the catalog |
Community tier means a reviewer merged the entry and pinned it to one commit, per the catalog trust model, but Nous Research does not maintain it.
Pick by where your data lives today. Got a recent export? Start with apple-health-mcp. Want a phone that keeps feeding the agent? Look at healthrelay or Health Sync.
Do This First, Whatever Route You Pick
Make a profile that holds nothing but health access. Plugins and their settings are per profile, and anyone who can invoke tools in that profile can request the data.
hermes profile create health # creates the profile and a health alias
health chat
Then pick the profile's model. Whatever the plugin returns can be sent to that provider. For a fully local loop, choose LM Studio or an Ollama custom endpoint from the provider list and give it at least 64,000 tokens of context.
Route 1: apple-health-analyzer (Mac App)
This is the entry added in the 15 November 2026 canary, titled Apple Health Data. It needs Hermes 0.23.1 or newer on the same Mac as the Health Data AI Analyzer app, per its catalog YAML.
health plugins install apple-health-analyzer
health config set plugins.entries.apple-health-analyzer.settings.allow_health_access true
health plugins enable apple-health-analyzer
- In the Mac app's Integrations screen, select a dataset (for example Use Last Analysis) and turn Local API on yourself.
- Put the token in the masked Mac app local API token field under Settings, Plugins. It is stored as
APPLE_HEALTH_ANALYZER_TOKEN. - Only flip
allow_health_accessby hand. The README says the agent must not enable it for you. - Test with: Check Apple Health Analyzer's connection. Then ask for steps and sleep on a date in your dataset.
Its README documents five metric groups (steps, sleep, workouts, heart_rate, hrv), one explicit date per call, and a date_unavailable error instead of a substituted day.
Route 2: apple-health-mcp (Export File)
davidmosiah's package runs apple-health-mcp-unofficial@0.8.0 over stdio through npx. Its catalog page lists workouts, steps, heart rate, HRV, sleep and cycle tracking.
# on iPhone: Health → profile → Export All Health Data, copy export.zip over
health plugins install davidmosiah/apple-health-mcp/agent-plugin --no-enable
health plugins enable apple-health-mcp
npx -y apple-health-mcp-unofficial@0.8.0 setup --auto-import --timezone Europe/London
npx -y apple-health-mcp-unofficial@0.8.0 doctor
Swap in your own IANA time zone. The package README also offers setup --import <path> for an explicit file and --watch-path <dir> to re-import newer exports dropped into a folder.
On first start, npx downloads the pinned package from npm. After that, its parsed cache lives locally, and the package's own reimport and cache-clear tools only touch your local copy.
The export step itself is Apple's: Export All Health Data produces everything in XML inside the zip. Data is only as fresh as your last export.
🔥 Want health and business agents already split into clean profiles? Inside the AI Profit Boardroom you get step-by-step video trainings, the installable Agent OS with Hermes, four coaching calls a week and 3,600+ members swapping plugin setups. → Join the AI Profit Boardroom
Route 3: healthrelay (Self-Hosted Receiver)
mwdearing's healthrelay entry is a Portable Agent Plugins v1 package: one stdio MCP server with ten read-only tools and three skills. There is no raw SQL and no write tool.
The plugin is only the agent side. The receiver and iPhone app come from the separate HealthRelay project, which sends HealthKit data to SQLite on your own machine over private HTTPS or LAN. There is no App Store listing, so you build the app or request a signed beta.
health plugins install healthrelay
# follow the healthrelay-setup skill to install receiver + iPhone app, then:
echo "/path/to/your/receiver.sqlite" > ~/.config/healthrelay/db-path
"${HERMES_HOME:-$HOME/.hermes}/plugins/healthrelay/bin/healthrelay-mcp" --check
Per the plugin README, the db-path file is the one supported route: environment variables exported in the Hermes shell don't reach the plugin. --check ends with result: OK or result: NOT READY, and the MCP server only loads at session start, so open a new session after it passes.
Route 4: health-insights (Reports On The Same Data)
health-insights adds skills plus a CLI that reads the HealthRelay receiver database. It is a reporting layer, not a separate connection.
pipx install git+https://github.com/mwdearing/hermes-health-insights@<40-char-sha>
health-insights demo --out demo.sqlite
health-insights weekly --db demo.sqlite
health plugins install health-insights
Run the demo first: it writes a synthetic database, so you can see the 7-day versus 28-day trend output without touching real data. The README says everything runs on your machine and labels the output informational only, not medical advice. health-insights doctor shows which database it resolved and how fresh it is.
Route 5: Health Sync For AI Agents (App Store)
Health Sync is an iPhone app built for OpenClaw. Its FAQ says Hermes Agent and other compatible agents use its Agent Skills package.
Onboarding pairs your agent and phone with a QR code, then you pick categories in the app. The App Store listing says data is encrypted on-device before upload, and syncs can run manually, on a schedule or when new data arrives.
It sits outside the Hermes catalog, so no Nous reviewer pinned a commit. Inspect the skills package before you load it into the health profile.
The vendor's own verification prompt after pairing is: What Apple Health data can I access? Run it in the health profile and confirm the list matches what you ticked on the phone.
If sync later fails with client_signing_key_mismatch, the FAQ says to have the agent create a fresh configuration and unlink the old device, then pair again in the app.
📞 Not sure which route fits the machines you already run? Book a free SEO strategy session and my team will match a route to your hardware and profiles. → Get your route mapped
Reading The Check Outputs
Each route has its own way of telling you the link works. Learn them before you ask for real numbers.
| Route | Check | Healthy answer |
|---|---|---|
| apple-health-analyzer | Check Apple Health Analyzer's connection. | App name, version, dataset loaded; no health values |
| apple-health-mcp | npx -y apple-health-mcp-unofficial@0.8.0 doctor | The doctor command finishes without errors |
| healthrelay | healthrelay-mcp --check | result: OK, exit 0 |
| health-insights | health-insights doctor | Exit 0; newest sample date and days with data per metric |
| Health Sync | What Apple Health data can I access? | The categories you approved in the app |
healthrelay redacts local paths in its check output as a placeholder by default. Add --show-paths only on your own machine, and never paste the real values anywhere.
health-insights uses exit code 1 as a warning when the newest data is older than three days by default, and 2 as an error when the database is missing or empty. A wrong path is always an error, never an empty report.
apple-health-analyzer Error Codes
| Code | Meaning | Fix |
|---|---|---|
consent_required | Health switch still off | Opt in yourself |
token_required / unauthorized | Missing or wrong token | Re-enter it in the masked field |
request_failed | App unreachable | App open, Local API on, same Mac |
dataset_unavailable | No dataset selected | Pick one in Integrations |
date_unavailable | Date not in the dataset | Choose a date that exists; nothing was shared |
invalid_response | App reply failed validation | Check app compatibility |
Calls time out after five seconds with no automatic retry, so a closed app reads as request_failed rather than a hang.
Gotchas Across All Five
- New session after install. MCP-based plugins load at session start; old chats won't see the tools.
- Null is not zero. apple-health-analyzer returns
nullfor missing values. Tell your prompts to write not recorded. - Stale exports. apple-health-mcp and the Mac app route never sync on their own.
- Docker HOME. healthrelay reads db-path from the Hermes process HOME, which can differ inside Docker.
- Missing MCP extra. If healthrelay tools vanish on a Docker image, the README's fix is
hermes pm install --extra mcp. - Pinned installs.
hermes plugins updaterefuses repo installs pinned to a commit; reinstall with--force --ref <sha>.
Where Each Route Keeps Your Data
- apple-health-analyzer: the Mac app holds the dataset; the plugin keeps no database, logs or files of its own.
- apple-health-mcp: your export.zip and the package's local parsed cache, on the machine you copied the zip to.
- healthrelay: the receiver's SQLite file on your own machine; the plugin README says nothing is sent to a hosted relay.
- health-insights: reads that same file, plus its own settings under
~/.config/health-insights/and imported data under~/.local/share/health-insights/. - Health Sync: data is encrypted on the phone and passes a relay that, per the vendor, holds no readable health data.
In every case, Hermes chat history and your model provider can also end up holding whatever the agent fetched.
Keep The Output As Records
Every route documents its output as recorded or informational data, not medical advice. Use the agent to fetch, tabulate and date your numbers.
Questions about what they mean go to a qualified professional, not the agent.
Turning A Route Off
- Disable with
health plugins disable <name>or remove withhealth plugins remove <name>, as listed in the CLI docs. - apple-health-analyzer: switch Allow health summaries off; every call rechecks it.
- healthrelay: optionally delete
~/.config/healthrelay/db-path; the receiver and its database stay untouched. - Clear old chats with your provider's retention controls. Removing a plugin doesn't erase them.
For the rest of the catalog, see our roundup of the best Hermes Agent plugins.
My Verdict: The Route I'd Run
Fastest first result: apple-health-mcp with yesterday's export. Freshest data on hardware you control: healthrelay, with health-insights on top for reports. Already a Mac app user: apple-health-analyzer. Want an App Store install and an encrypted relay: Health Sync.
Whichever you pick, start in a private profile with a local model. If you want the stack around it, join the AI Profit Boardroom or grab a free strategy session with my team.
Also On Our Network
- 🌐 The five ways a business owner can connect Apple Health to Hermes, in plain English
- 🌐 All five Apple Health options for Hermes compared on what they need and who they suit
- 🌐 The five bridges that connect Apple Health to an Agent OS, with check prompts
- 🌐 A step-by-step guide to connecting Apple Health to Hermes with five connectors
- 🌐 The complete Hermes Agent Apple Health guide on AI Profit Boardroom
FAQ: Hermes Agent Apple Health
What is the quickest way to connect Apple Health to Hermes?
apple-health-mcp. Export from the Health app, copy export.zip to the machine, install the plugin and run its setup command.
Which route keeps syncing without manual exports?
healthrelay, whose iPhone app sends data to a receiver you host, and the Health Sync app, which syncs manually, on a schedule or when new data appears.
Why can't Hermes see the healthrelay database path I exported?
The plugin only reads ~/.config/healthrelay/db-path. Shell environment variables don't reach it, so write the path to that file and start a new session.
Is health-insights a separate way to connect?
No. It reads the same HealthRelay receiver database and adds local reports through skills and a CLI. Install healthrelay first.
Does apple-health-analyzer work on a VPS?
No. It is macOS only and needs Hermes on the same Mac as the Health Data AI Analyzer app.
Are any of these routes official Nous Research plugins?
No. The four catalog entries are community tier, and Health Sync is a third-party app outside the catalog.
📺 Video notes + links to the tools 👉
🎥 Learn how I make these videos 👉
🆓 Get a FREE AI Course + Community + 1,000 AI Agents 👉
About Julian
I'm Julian Goldie, an SEO entrepreneur, author and founder of the AI Profit Boardroom, which has 3,400+ members.
I help business owners scale with AI agents, automation and SEO.
- I've built a 7-figure SEO and link building agency, Goldie Agency, with a team of 70+ SEO experts.
- I've grown a YouTube channel to 400,000+ subscribers.
- I wrote "Link Building Mastery".
- My Udemy courses have taught over 29,000 students.
→ Get my best AI training inside the AI Profit Boardroom
Pick the route, make the private profile, run the check command, and if you want help with the rest, book a free SEO strategy session or learn the full setup in the AI Profit Boardroom and finish your hermes agent apple health connection today.











