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

OptionWhat it doesWhat it needsBest for
apple-health-mcp (davidmosiah)Local MCP server parses your Health export: workouts, steps, heart rate, HRV, sleep, cycle trackingAn 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 APImacOS, Hermes 0.23.1+, Health Data AI Analyzer on the same MacPeople already using that Mac app
healthrelay (mwdearing)Ten read-only MCP tools over a database fed by your phoneA self-hosted HealthRelay receiver and its iPhone appFresh data on hardware you control
health-insights (mwdearing)Local trend reports via skills plus a CLIA working HealthRelay receiver database, pipxhealthrelay users who want summaries
Health Sync for AI AgentsiPhone app syncs chosen categories with end-to-end encryptionThe App Store app and its Agent Skills packageAn 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

OptionFreshnessMoving partsExtra software
apple-health-mcpSnapshot at export timeExport, copy, setup commandNode.js 20+, npm package fetched on first start
apple-health-analyzerWhatever the Mac app last importedApp dataset, Local API, token, opt-inHealth Data AI Analyzer for Mac
healthrelayOngoing, from the phoneReceiver, iPhone app, db-path file, checkHealthRelay receiver and iPhone app
health-insightsAs fresh as the receiverCLI install, plugin install, database pathpipx, plus healthrelay's receiver
Health SyncManual, scheduled or on new dataApp install, QR pairing, category choiceThe 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-path file 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

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.