---
title: Apple Health MCP connector
description: Reads your local Apple Health export with no live HealthKit dependency.
canonical: https://wellness.delx.ai/connectors/apple-health
content_signal: ai-train=no, search=yes, ai-input=yes
---

# Apple Health MCP Connector

A local parser for Apple Health exports that lets MCP clients summarize activity, sleep, heart, HRV, workouts and body records.

## Install

```bash
npx -y apple-health-mcp-unofficial setup --export-path /path/to/export.zip
npx -y apple-health-mcp-unofficial doctor
```

## Agent client config

```json
{
  "mcpServers": {
    "apple_health": {
      "command": "npx",
      "args": ["-y", "apple-health-mcp-unofficial"]
    }
  }
}
```

## Signals

- Activity
- Sleep
- Heart Rate
- HRV
- Workouts

## Data availability

- Activity: available. Steps, distance, energy and exercise records.
- Heart rate: available. Recorded samples and resting heart rate.
- Sleep analysis and stages: available. When iPhone or Apple Watch logs sleep.
- Workouts and sport metadata: available. All HKWorkout entries in the export.
- Body measurements: available. Weight, BMI and body fat when logged.
- HRV and breathing rate: available. Available when Apple Watch supports and records them.
- ECG waveform: conditional. Metadata is available; raw waveform requires PDF export.
- Live HealthKit or iCloud Health sync: not_available. Not exposed by export files.

## MCP tools

### Start here

- `apple_health_connection_status`
- `apple_health_daily_summary`
- `apple_health_weekly_summary`

### Diagnostics

- `apple_health_capabilities`
- `apple_health_agent_manifest`
- `apple_health_privacy_audit`

### Records

- `apple_health_list_records`
- `apple_health_list_workouts`

## Prompts

- `apple_health_daily_review`
- `apple_health_weekly_review`

## Resources

- `apple-health://capabilities`
- `apple-health://agent-manifest`
- `apple-health://summary/daily`
- `apple-health://summary/weekly`

## Privacy

- No OAuth or cloud token is required.
- All parsing happens from a local export path.
- The agent sees MCP responses, not the user's entire export by default.
- Good fit for private, server-side Hermes deployments when the export file is controlled.

## Best for

- Apple Watch weekly review
- Local health archive summarization
- Workout and sleep trend review
- No-cloud wellness context

## Known limits

- Not live HealthKit.
- Requires a manual export refresh.
- Very large exports can take time to parse.

## Links

- GitHub: https://github.com/davidmosiah/apple-health-mcp
- npm: https://www.npmjs.com/package/apple-health-mcp-unofficial
- Provider docs: https://support.apple.com/guide/iphone/share-health-and-fitness-data-iph27f6325b2/ios