apple-health-mcp

# apple-health-mcp An MCP server for Apple Health data. Reads daily health metrics and workouts exported by the [Health Auto Export](https://apps.apple.com/app/health-auto-export-json-csv/id1115567461) 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](https://apps.apple.com/app/health-auto-export-json-csv/id1115567461), 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. 1. Install [Health Auto Export](https://apps.apple.com/app/health-auto-export-json-csv/id1115567461) from the App Store 2. Open the app and grant it access to Apple Health data when prompted 3. 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** 4. The app will export CSV files to iCloud Drive, which syncs automatically to your Mac at: ``` ~/Library/Mobile Documents/iCloud~com~ifunography~HealthExport/Documents/ ``` 5. Verify the files are syncing by checking that the directory contains `Daily Export/` and `Workouts/` folders with dated CSV files ### 2. Install ```bash 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`: ```json { "mcpServers": { "apple-health": { "type": "stdio", "command": "node", "args": ["/path/to/apple-health-mcp/dist/mcp.js"] } } } ``` Or register with the Claude CLI: ```bash 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: ```json { "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](https://apps.apple.com/app/health-auto-export-json-csv/id1115567461) iOS app ## License MIT