apple-health-mcp-unofficial
Apple Health MCP connector
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.
MCP server answers
The Apple Health MCP server is the local process provided by apple-health-mcp-unofficial. Add its MCP configuration to a compatible client and it exposes the provider records listed on this page to that client. It is not an official Apple Health product and Delx does not host a copy of the data.
Compare this connector with the other wellness pathsWhat is the Apple Health MCP server?
The Apple Health MCP server is the local process provided by apple-health-mcp-unofficial. Add its MCP configuration to a compatible client and it exposes the provider records listed on this page to that client. It is not an official Apple Health product and Delx does not host a copy of the data.
How do I install Apple Health MCP?
Run npx -y apple-health-mcp-unofficial setup --export-path /path/to/export.zip, then npx -y apple-health-mcp-unofficial doctor. The Quick Start section below contains the client configuration and provider-specific setup.
What can an agent read from Apple Health?
The available records start with Activity, Heart rate, Sleep analysis and stages, Workouts and sport metadata. Check Data Availability for scope, device and export limitations before using any result.
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
Profile and onboarding
- apple_health_profile_get
- apple_health_profile_update
- apple_health_onboarding
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