# Apple Health Mcp

> MCP server for Apple Health data — reads Health Auto Export CSVs from iCloud Drive

- **Type:** MCP server
- **Install:** `agentstack add mcp-daveremy-apple-health-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [daveremy](https://agentstack.voostack.com/s/daveremy)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [daveremy](https://github.com/daveremy)
- **Source:** https://github.com/daveremy/apple-health-mcp

## Install

```sh
agentstack add mcp-daveremy-apple-health-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [daveremy](https://github.com/daveremy)
- **Source:** [daveremy/apple-health-mcp](https://github.com/daveremy/apple-health-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-daveremy-apple-health-mcp
- Seller: https://agentstack.voostack.com/s/daveremy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.