MetricBridge Apple Health MCP server

health-export-mcp, Apple Health MCP server for AI agents

Query your Apple Health data from Claude, ChatGPT, Cursor, OpenClaw, Hermes, and any other AI agent.

health-export-mcp is an open-source, zero-dependency Model Context Protocol (MCP) server that lets any MCP-compatible AI agent query your Apple Health / HealthKit data, 190 metrics as clean JSON, in plain language. Local-first, read-only, no accounts, and no developer server in the path. It's the open-source server for the MetricBridge iOS app, available on the App Store.

Ask your agent: "Compare my HRV this week vs last week and tell me if I'm recovering.", it calls the tools and answers from your actual numbers.

What is health-export-mcp?

It's an MCP server that turns your Apple Health export into a tool your AI agent can query in natural language, HRV, sleep, resting heart rate, steps, workouts, VO₂ max, and 180+ more.

• Who it's for: anyone who wants their AI to reason over their real health data instead of a stale CSV.
• What it isn't: a cloud service. There's no developer server in the path, your data goes only where you point it.
• Setup: point the server at your exported data and add it to your AI client.

Just exported and the Mac has not seen it yet? iCloud can take a few minutes to sync the

file across, so a check 60 seconds after tapping Run in the app can still show the old

timestamp. getmcpstatus reports lastDataDate and the intraday lastWrite, which is the

quickest way to tell "still syncing" from "never arrived".

Try it with no iPhone needed: node server.mjs --demo serves a deterministic synthetic dataset (400 days, workouts, events, sleep sessions) with every answer watermarked as synthetic. Or run npm test to write a sample cache and exercise every tool.

Connect Apple Health to your AI agent, Quickstart

1. Get your Apple Health data flowing

The companion iOS app MetricBridge exports your Apple Health data, read-only, automatic, private. For this MCP server, export to a destination it can read:

Using a non-MCP tool (ChatGPT, n8n, Home Assistant)? The app can also POST to a webhook those tools read directly, see Works with.

2. Add the server to your agent

Shortened. The full README is on GitHub.