Apple Health Mcp
Let Claude Code or Cursor query your exported Apple Health XML/ZIP locally without sending raw records to a cloud API.
Overview
io.github.davidmosiah/apple-health-mcp is a MCP server for the Build phase that exposes local Apple Health exports to agents with configurable privacy and timezone-aware summaries.
What is this MCP server?
- Reads export.xml, a full export directory, or export.zip via APPLE_HEALTH_EXPORT_PATH
- Privacy modes: summary (default), structured, or raw via APPLE_HEALTH_PRIVACY_MODE
- Daily and weekly summaries respect local days with APPLE_HEALTH_TIMEZONE (IANA)
- Optional APPLE_HEALTH_WATCH_PATH auto-promotes the newest export and refreshes summaries
- Local-first stdio npm package apple-health-mcp-unofficial v0.5.0—no vendor API key
- Server version 0.5.0
- Transport: stdio
- npm identifier: apple-health-mcp-unofficial
What problem does it solve?
Agents cannot see your Apple Health history unless you manually slice exports or ship data to a third-party API you do not want to run.
Who is it for?
Indie builders on macOS who already export Apple Health and want agent-driven analysis during app or content prototyping.
Skip if: Teams that need live HealthKit streaming, HIPAA-hosted pipelines, or Android-only health stacks without an export workflow.
What do I get? / Deliverables
Your agent can query steps, workouts, and trends from on-disk exports with summary-first defaults and optional watch-folder refresh.
- Agent-callable summaries and structured health metrics from your export
- Timezone-aligned daily and weekly rollups
- Optional auto-refresh when new exports land in a watch folder
Recommended MCP Servers
Journey fit
Wellness and quantified-self products need agent-accessible health metrics while you are wiring integrations during the build phase. This is a stdio MCP bridge from your machine’s Health export files into tool calls—not a hosted database or analytics dashboard by itself.
How it compares
Local file MCP integration, not Apple’s official HealthKit SDK or a hosted FHIR warehouse.
Common Questions / FAQ
Who is apple-health-mcp for?
Solo developers and founders building wellness, fitness, or personal-data products who want Claude or Cursor to read their own exported Health data on-machine.
When should I use apple-health-mcp?
Use it when you have export.xml or a zip from the Health app and need timezone-correct daily or weekly summaries inside an agent session during integration work.
How do I add apple-health-mcp to my agent?
Install the npm package apple-health-mcp-unofficial, set APPLE_HEALTH_EXPORT_PATH (and optional timezone, privacy mode, and watch path), and register the server as a stdio MCP entry in Claude Code, Cursor, or Claude Desktop.