apple-health-mcp-unofficial
Apple Health
A local parser for Apple Health exports that lets MCP clients summarize activity, sleep, heart, HRV, workouts and body records.
Best for users who want Apple Health context in an agent without relying on a live API, cloud sync or background mobile service.
Quick Start
npx -y apple-health-mcp-unofficial setup --export-path /path/to/export.zip
npx -y apple-health-mcp-unofficial doctor{
"mcpServers": {
"apple_health": {
"command": "npx",
"args": ["-y", "apple-health-mcp-unofficial"]
}
}
}- 01
Export All Health Data from the iPhone Health app.
- 02
AirDrop or transfer export.zip to the machine running the agent.
- 03
Run setup with --export-path and then doctor.
Data Availability
Activity
Steps, distance, energy and exercise records.
Heart rate
Recorded samples and resting heart rate.
Sleep analysis and stages
When iPhone or Apple Watch logs sleep.
Workouts and sport metadata
All HKWorkout entries in the export.
Body measurements
Weight, BMI and body fat when logged.
HRV and breathing rate
Available when Apple Watch supports and records them.
ECG waveform
Metadata is available; raw waveform requires PDF export.
Live HealthKit or iCloud Health sync
Not exposed by export files.
Agent Tools
Start here
- apple_health_connection_status
- apple_health_daily_summary
- apple_health_weekly_summary
Diagnostics
- apple_health_capabilities
- apple_health_agent_manifest
- apple_health_privacy_audit
Records
- apple_health_list_records
- apple_health_list_workouts
Prompts and Resources
Prompts
- apple_health_daily_review
- apple_health_weekly_review
Resources
- apple-health://capabilities
- apple-health://agent-manifest
- apple-health://summary/daily
- apple-health://summary/weekly