README.md
Query Apple Health metrics, workouts, and trends from local CSV exports
apple-health-mcp
An MCP server for Apple Health data. Reads daily health metrics and workouts exported by the Health Auto Export iOS app.
Features
- MCP Server: 3 tools for querying Apple Health data from Claude Code or any MCP client
- No API keys needed: Reads local CSV files exported by Health Auto Export to iCloud Drive
- Comprehensive: Steps, HR, HRV, SpO2, sleep stages, body composition, workouts
MCP Tools
| Tool | Description |
|---|---|
apple_health_daily |
Daily summary: steps, energy, HR, HRV, sleep stages, body comp, workouts |
apple_health_workouts |
Workout sessions for a date (type, duration, HR, calories, distance) |
apple_health_trends |
Multi-day trends for steps, HR, HRV, sleep, weight |
Setup
1. Set up Health Auto Export on iPhone
This MCP server reads CSV files produced by Health Auto Export, a third-party iOS app that automatically exports Apple Health data to iCloud Drive. The app runs in the background and syncs new data throughout the day.
- Install Health Auto Export from the App Store
- Open the app and grant it access to Apple Health data when prompted
- Go to Automations and create two automations:
- Daily Metrics: Select the health metrics you want (steps, heart rate, sleep, etc.), set format to CSV, frequency to Daily, and destination to iCloud Drive
- Workouts: Select workout data, set format to CSV, frequency to Daily, and destination to iCloud Drive
- The app will export CSV files to iCloud Drive, which syncs automatically to your Mac at:
~/Library/Mobile Documents/iCloud~com~ifunography~HealthExport/Documents/ - Verify the files are syncing by checking that the directory contains
Daily Export/andWorkouts/folders with dated CSV files
2. Install
git clone https://github.com/daveremy/apple-health-mcp.git
cd apple-health-mcp
npm install
npm run build
3. Use as MCP Server
Add to your Claude Code project's .mcp.json:
{
"mcpServers": {
"apple-health": {
"type": "stdio",
"command": "node",
"args": ["/path/to/apple-health-mcp/dist/mcp.js"]
}
}
}
Or register with the Claude CLI:
claude mcp add apple-health --scope project -- node /path/to/apple-health-mcp/dist/mcp.js
Custom Export Directory
If your Health Auto Export saves to a different location, set the environment variable:
{
"env": {
"APPLE_HEALTH_EXPORT_DIR": "/path/to/your/export/directory"
}
}
Data Format
The server expects the CSV file structure produced by Health Auto Export:
Documents/
Daily Export/
HealthMetrics-YYYY-MM-DD.csv
Workouts/
Workouts-YYYY-MM-DD.csv
Requirements
- Node.js 18+
- macOS (for iCloud Drive access)
- Health Auto Export iOS app
License
MIT
Tools (3)
apple_health_dailyProvides a daily summary including steps, energy, HR, HRV, sleep stages, body composition, and workouts.apple_health_workoutsRetrieves workout sessions for a specific date including type, duration, HR, calories, and distance.apple_health_trendsAnalyzes multi-day trends for steps, HR, HRV, sleep, and weight.Environment Variables
APPLE_HEALTH_EXPORT_DIRCustom directory path for Health Auto Export CSV files if not using the default iCloud path.Configuration
claude_desktop_config.json
{"mcpServers": {"apple-health": {"type": "stdio", "command": "node", "args": ["/path/to/apple-health-mcp/dist/mcp.js"]}}}Try it
→What was my average heart rate and sleep duration over the last 7 days?
→Show me a summary of my workout activity for yesterday.
→Analyze my step count trends for the past month.
→Did I meet my activity goals based on my health data from last week?