Hermes agent apple health connections split into five choices, and the deciding question is where you want the copy of your data to live: in an export file, inside a Mac app, on a receiver you host, or behind an encrypted sync app on your phone.
This page compares the five on what each one does, what it needs and who it suits, then lists the mistakes that trip people up.
There are no scores here. The options do different jobs, so the useful question is fit, not rank.
For a second opinion on your own stack, book a free SEO strategy session with my team.
The Comparison Table
| Option | What it does | What it needs | Best for |
|---|---|---|---|
| apple-health-mcp (davidmosiah) | Local MCP server parses your Health export: workouts, steps, heart rate, HRV, sleep, cycle tracking | An export.zip on disk, Node.js 20+ | A fast, one-off connection with no extra app |
| apple-health-analyzer (krumjahn) | Reads one date of five metric groups from a Mac app's Local API | macOS, Hermes 0.23.1+, Health Data AI Analyzer on the same Mac | People already using that Mac app |
| healthrelay (mwdearing) | Ten read-only MCP tools over a database fed by your phone | A self-hosted HealthRelay receiver and its iPhone app | Fresh data on hardware you control |
| health-insights (mwdearing) | Local trend reports via skills plus a CLI | A working HealthRelay receiver database, pipx | healthrelay users who want summaries |
| Health Sync for AI Agents | iPhone app syncs chosen categories with end-to-end encryption | The App Store app and its Agent Skills package | An app-first setup with no self-hosting |
Sources: the catalog pages for apple-health-mcp, apple-health-analyzer, healthrelay and health-insights, plus the Health Sync site.
What each option is, in one line
- apple-health-mcp is a reader for the file Apple already lets you export.
- apple-health-analyzer is a narrow window into a Mac app that holds your imported data.
- healthrelay is a live pipe from your phone to a database you own.
- health-insights is a report writer that sits on top of that same database.
- Health Sync is an App Store app that handles the pipe for you, encrypted.
Catalog Status And Why It Matters
The first four sit in the community tier of the Hermes catalog. The catalog docs say a human merges every entry and pins it to an exact commit, so an author pushing new code does not change what you install until another reviewed pull request moves the pin.
Health Sync is not in the catalog. That is not a mark against it, but it means no Nous reviewer pinned a version. You review its skills package yourself.
None of the five is built or maintained by Nous Research.
Practically, catalog status changes how you install. A catalog name such as healthrelay installs the reviewed pin. A repo install with --ref follows whatever commit you name, and Hermes then asks the normal install questions.
For Health Sync, the vendor site is your only source on how the skills package behaves, so read it before installing.
Decision 1: How Fresh Does The Data Need To Be?
If a snapshot is fine, the export route and the Mac app route both work. Neither syncs on its own.
If you want new days to appear without exporting, you need a sync: healthrelay sends from the phone to your receiver, and the Health Sync app can sync manually, on a schedule or when new data arrives.
Decision 2: Where Will Hermes Run?
- On a Mac next to the analyzer app: apple-health-analyzer is available to you. It is macOS only and does not work across machines.
- On a server or Linux box: apple-health-mcp (copy the zip across), healthrelay (receiver on that box) or Health Sync.
- In Docker: healthrelay works but reads its db-path file from the Hermes process HOME, which can differ inside a container.
๐ฅ Want to see these routes running inside a full agent stack before you choose? 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 comparing plugin setups before they install them. โ Join the AI Profit Boardroom
Decision 3: How Much Do You Want To Self-Host?
healthrelay asks the most. The plugin is only the agent side. The receiver and the iPhone app come from the separate HealthRelay project, which has no App Store listing: you build the app or ask for a signed beta.
apple-health-mcp asks for Node.js and a file copy. apple-health-analyzer asks for a Mac app, a token and an opt-in switch. Health Sync asks for an App Store install and a QR pairing.
Decision 4: Who Else Can Reach The Agent?
This one decides more setups than any feature. Plugin access applies to a whole Hermes profile, and the apple-health-analyzer README warns that anyone able to invoke tools in that profile can request the data.
The other four don't change that rule. healthrelay's tools and Health Sync's skills are just as reachable by anyone who can message the profile.
So whichever option you choose, put it in its own profile with no team gateway. The Hermes profiles docs show how one command creates it.
How The Data Reaches Each Option
Export file
On iPhone, Health lets you export all of your health and fitness data in XML. apple-health-mcp parses that zip, and the analyzer's Mac app imports it.
Phone-to-receiver sync
The HealthRelay iPhone app reads HealthKit and sends to SQLite on your machine over private HTTPS or a local network. healthrelay and health-insights both read that database.
Encrypted app sync
Health Sync encrypts on the device before upload, and its site says the relay holds no readable health data and no inbound ports are needed.
Freshness, Setup And Footprint Side By Side
| Option | Freshness | Moving parts | Extra software |
|---|---|---|---|
| apple-health-mcp | Snapshot at export time | Export, copy, setup command | Node.js 20+, npm package fetched on first start |
| apple-health-analyzer | Whatever the Mac app last imported | App dataset, Local API, token, opt-in | Health Data AI Analyzer for Mac |
| healthrelay | Ongoing, from the phone | Receiver, iPhone app, db-path file, check | HealthRelay receiver and iPhone app |
| health-insights | As fresh as the receiver | CLI install, plugin install, database path | pipx, plus healthrelay's receiver |
| Health Sync | Manual, scheduled or on new data | App install, QR pairing, category choice | The App Store app and its skills package |
The pattern is clear: the more current you want the data, the more you have to run or trust between your phone and your agent.
With an export, nothing sits between phone and agent except you copying a file. With healthrelay, you run the middle piece yourself. With Health Sync, a vendor's relay sits in the middle, carrying data the vendor says it cannot read.
None of those is wrong. They are different trust trade-offs, and the table makes them visible before you install.
What Each Option Leaves Out
- apple-health-analyzer drops narrative signals, recovery scores, workout types and sleep times, and returns only the groups you name.
- apple-health-mcp has no live sync, and its tool set comes from the pinned npm version.
- healthrelay has no write tools and no raw SQL, and it caps time-series answers at 500 points.
- health-insights doesn't connect to anything by itself; without a receiver database it exits with an error.
- Health Sync shares only the categories you approve in the app.
Knowing the gaps up front saves you from blaming a plugin for doing exactly what it documents. Read each README's limits section before you install.
Upgrade Paths
Most people don't need to pick forever. A common path is to start with an export through apple-health-mcp, decide the data is worth having in the agent, then move to a sync.
From there, healthrelay suits people who already run services at home, and health-insights adds reports with no new data path. Health Sync suits people who would rather not host anything.
Remove the old plugin from the profile when you switch, so the agent doesn't mix a stale export with fresh synced data.
Common Mistakes
- Installing into the team profile. The fastest way to put personal numbers one message away from a colleague.
- Expecting live data from an export. The zip is a snapshot. Re-export or switch to a sync route.
- Setting healthrelay's path as an environment variable. The plugin README says only the
~/.config/healthrelay/db-pathfile is supported. - Installing health-insights first. It needs the HealthRelay receiver database to exist.
- Pasting tokens into chat. apple-health-analyzer has a masked settings field for that reason.
- Forgetting the model. Results reach your profile's provider. Use a local model from the Hermes provider list if you want them to stay home.
- Asking for interpretation. Every option documents its output as records or information, not medical advice.
๐ Torn between two routes for your own setup? Book a free SEO strategy session and my team will tell you which one fits your machines and profiles. โ Get a free second opinion
Who Each Option Suits
- apple-health-mcp: anyone trying this for the first time.
- apple-health-analyzer: Mac users of the analyzer app who like one-date, tightly limited reads.
- healthrelay + health-insights: technical users who already self-host services.
- Health Sync: people who want a phone app to manage the sync and are comfortable reviewing a third-party skills package.
Who Should Wait
Anyone hoping for interpretation should also wait, because none of these tools is built for that and each says so in its own documentation.
Teams that want shared health dashboards should wait: none of the five offers per-person permissions inside one profile.
Anyone who needs a guided product with a support contract should also wait. Four options are community plugins only weeks or months old, maintained by individuals.
For broader plugin picks, see our list of the best Hermes Agent plugins and the 15 November 2026 canary notes where the newest health entry appeared.
My Verdict: Which To Pick
Start with apple-health-mcp to see whether the data is useful to your agent at all. If it is, move to healthrelay for fresh data you host, or Health Sync if you'd rather not run a receiver. Pick apple-health-analyzer only if the Mac app is already part of your routine.
For the Agent OS and setup trainings behind any of these, join the AI Profit Boardroom.
Also On Our Network
- ๐ The exact install commands for all five ways to connect Apple Health to Hermes
- ๐ The five ways a business owner can connect Apple Health to Hermes, in plain English
- ๐ 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: How To Connect Apple Health To Hermes Agent
Which Apple Health option should I try first in Hermes?
apple-health-mcp. It only needs an export.zip and Node.js 20+, so it is the quickest way to see whether the data is useful.
Which options work without a Mac?
apple-health-mcp, healthrelay, health-insights and Health Sync. Only apple-health-analyzer is macOS only.
What is the difference between healthrelay and health-insights?
healthrelay gives Hermes read-only tools over your receiver database. health-insights writes local trend reports from the same database and needs healthrelay's receiver in place.
Is Health Sync a Hermes plugin?
No. It is an iPhone app outside the Hermes catalog that supports Hermes through its Agent Skills package.
Can several people share one health profile?
They shouldn't. Plugin access covers the whole profile, so anyone using it could request the data.
Is any option official from Nous Research?
No. The catalog entries are community tier and Health Sync is a third-party app.
๐บ 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
Match the option to your machines, then grab a free SEO strategy session with my team, or compare notes in the AI Profit Boardroom, if you want help choosing your hermes agent apple health route.











