Which integrations are available for this server?

Provides tools to query Apple Health data, including daily health metrics such as steps, heart rate, sleep stages, and body composition, as well as detailed workout session records. Accesses health metrics and workout data exported from iOS devices and automatically synced to iCloud Drive.

How do I use Apple Health MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Apple Health MCP How many steps did I take yesterday and what was my sleep like?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Looking for Admin?

Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.

Apple Health MCP