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 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.

1. Install Health Auto Export 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

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