MetricBridge Apple Health — Claude Code MCP server for Apple Health
Serves 190 Apple Health metrics to your agent from a local export: sleep, HRV, resting heart rate, steps, workouts. Read-only, no account, nothing leaves your machine.
claude mcp add health-export-mcp -- npx -y health-export-mcpWhat MetricBridge Apple Health does
The server starts from a single command and runs through npx, so there is no separate install step. It ships 16 tools and 22 prompts and answers in plain JSON. Data comes from the MetricBridge iOS app export, which you can drop in iCloud Drive, a local folder, or push over your LAN. The server only reads.
Point it at your folder with HEALTH_DATA_DIR. The iCloud folder name contains a space, so the path goes in double quotes and $HOME stands in for ~ — quoting stops the shell from expanding a tilde. No export yet? Run it with --demo and it serves a synthetic set covering 400 days, with every answer marked as synthetic.
A fresh export may not show up right away, because iCloud needs time to sync the file; a check a minute after you tap Run can still report the old timestamp. The get_mcp_status tool returns lastDataDate plus the intraday lastWrite, which tells syncing apart from a file that never arrived. By default the server is registered for the current project only; add --scope user to make it available everywhere.
What it helps with
- compare this week's HRV against last week
- track resting heart rate over a month
- break down sleep sessions by length
- pull workouts and VO₂ max into one report
- check whether a fresh iCloud export landed
Example prompts for the agent
- Show how my resting heart rate changed over the past month.
- Use
get_mcp_statusto check when the latest data arrived.
How to install MetricBridge Apple Health
Platform CLI
claude mcp add health-export-mcp -- npx -y health-export-mcpPlatform CLI
codex mcp add metricbridge-apple-health -- npx -y health-export-mcpConfig file
{
"mcpServers": {
"metricbridge-apple-health": {
"command": "npx",
"args": [
"-y",
"health-export-mcp"
]
}
}
}Config file
{
"servers": {
"metricbridge-apple-health": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"health-export-mcp"
]
}
}
}Platform CLI
gemini mcp add metricbridge-apple-health npx -y health-export-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MetricBridge Apple Health
How do I install MetricBridge Apple Health in Claude Code?
Run claude mcp add health-export-mcp -- npx -y health-export-mcp. The server launches through npx, so no separate package install is needed. Use claude mcp list to confirm it registered.
What does MetricBridge Apple Health do?
It reads your Apple Health export locally and answers agent questions across 190 metrics: sleep, HRV, resting heart rate, steps, workouts, VO₂ max. It includes 16 tools and 22 prompts, and replies in JSON.
Can I try it without an iPhone?
Yes. Start it with npx -y health-export-mcp --demo and it serves a synthetic dataset of 400 days with workouts, events and sleep sessions. Every answer in that mode is watermarked as synthetic.
