Apple Health Mcp

Name: Apple Health Mcp
Author: davidmosiah

by davidmosiahcommunityv0.5.0

Local-first MCP server that reads Apple Health export files (`export.xml`, `export.zip`, or an unzipped export folder) and exposes health data to AI agents. It supports activity, sleep, heart rate, HRV, workouts, body measurements, and some ECG metadata from the user’s exported Apple Health data.

From the registry: Unofficial local-first MCP server for Apple Health export data.

GitHub Repository Website

Install & configure

Prerequisites

required
Install Node.js 20+
Node.js 20 or newer is required to run the MCP server via npx.
required
Export Apple Health data from your iPhone
Create an Apple Health export from the Health app and transfer the resulting export.zip, export.xml, or unzipped export folder to the machine where the MCP server will run.
https://support.apple.com/guide/iphone/share-health-and-fitness-data-iph27f6325b2/ios
required
Run setup to save local configuration
Use the package setup command to store the export path and optional settings in the local config file before starting the server. You can also use --auto-import to find and copy the newest export from common folders.
```
$ npx -y apple-health-mcp-unofficial setup --export-path <path-to-export.zip>
```
optional
Verify configuration
Run the doctor command to confirm the export path and setup are valid.
```
$ npx -y apple-health-mcp-unofficial doctor
```

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `apple-health-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install Node.js 20+** — Node.js 20 or newer is required to run the MCP server via npx.
- **Export Apple Health data from your iPhone** — Create an Apple Health export from the Health app and transfer the resulting export.zip, export.xml, or unzipped export folder to the machine where the MCP server will run. (https://support.apple.com/guide/iphone/share-health-and-fitness-data-iph27f6325b2/ios)
- **Run setup to save local configuration** — Use the package setup command to store the export path and optional settings in the local config file before starting the server. You can also use --auto-import to find and copy the newest export from common folders. Run: `npx -y apple-health-mcp-unofficial setup --export-path <path-to-export.zip>`

Optional prerequisites:
- Verify configuration — Run the doctor command to confirm the export path and setup are valid. Run: `npx -y apple-health-mcp-unofficial doctor`

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","apple-health-mcp-unofficial"]
- required environment variables:
  - `APPLE_HEALTH_EXPORT_PATH`: Path to your Apple Health export file or folder. Supported values are export.zip, export.xml, or an unzipped apple_health_export directory. The README indicates setup usually saves this locally, but the server needs it in the default configuration to function. (example: `<path-to-export.zip>`)
- optional environment variables:
  - `APPLE_HEALTH_PRIVACY_MODE`: Privacy level for exposed data. Supported values: summary, structured, raw. Defaults to summary. (example: `<summary|structured|raw>`)
  - `APPLE_HEALTH_TIMEZONE`: Timezone used for local-day summaries. Defaults to UTC unless setup saves a timezone. (example: `<your-timezone>`)

Note: Preferred portable install path is the npm package via npx. The README also mentions an optional local HTTP transport for development only, but the standard MCP client configuration shown uses stdio. The setup command writes settings to ~/.apple-health-mcp/config.json, so some clients may work without explicitly setting env vars if that file is present.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Preferred portable install path is the npm package via npx. The README also mentions an optional local HTTP transport for development only, but the standard MCP client configuration shown uses stdio. The setup command writes settings to ~/.apple-health-mcp/config.json, so some clients may work without explicitly setting env vars if that file is present.

Tools (9)

apple_health_connection_status

Verify the export path and connection setup before reading data

apple_health_data_inventory

Discover available record types, date coverage, source counts, and stale export risk

apple_health_daily_summary

Generate a daily wellness brief from the export data

apple_health_weekly_summary

Generate a weekly comparison and habit-signal summary

apple_health_capabilities

Show connector capabilities

apple_health_agent_manifest

Expose the agent manifest

apple_health_privacy_audit

Run a privacy audit of the connector or export handling

apple_health_list_records

List bounded records by type, start/end range, and limit

apple_health_list_workouts

List bounded workout records

Environment variables

APPLE_HEALTH_EXPORT_PATHrequiredPath to the Apple Health export file or folder to read

APPLE_HEALTH_PRIVACY_MODEControls output detail level: summary, structured, or raw

APPLE_HEALTH_TIMEZONETimezone used for local-day summaries

Prerequisites

• Node.js 20+

Packages

apple-health-mcp-unofficial

npmv0.5.0transport: stdio

Details

Language: TypeScript
License: MIT
Released: May 29, 2026
Last commit: Jun 20, 2026
Registry name: io.github.davidmosiah/apple-health-mcp

Related Servers

Netdata

Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.

79.6k

Labelhead Artist Momentum

Trending hip-hop artist momentum scores across four cultural dimensions.

73.2k

Scrapling

Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.

68.9k