# MetricBridge Apple Health

Serves 190 Apple Health metrics to your agent from a local export: sleep, HRV, resting heart rate, steps, workouts. Read-only, no account, nothing leaves your machine.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: PhilipAD
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PhilipAD/health-export-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/metricbridge-apple-health

## What it does

The server starts from a single command and runs through `npx`, so there is no separate install step. It ships 16 tools and 22 prompts and answers in plain JSON. Data comes from the MetricBridge iOS app export, which you can drop in iCloud Drive, a local folder, or push over your LAN. The server only reads.

Point it at your folder with `HEALTH_DATA_DIR`. The iCloud folder name contains a space, so the path goes in double quotes and `$HOME` stands in for `~` — quoting stops the shell from expanding a tilde. No export yet? Run it with `--demo` and it serves a synthetic set covering 400 days, with every answer marked as synthetic.

A fresh export may not show up right away, because iCloud needs time to sync the file; a check a minute after you tap Run can still report the old timestamp. The `get_mcp_status` tool returns `lastDataDate` plus the intraday `lastWrite`, which tells syncing apart from a file that never arrived. By default the server is registered for the current project only; add `--scope user` to make it available everywhere.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add health-export-mcp -- npx -y health-export-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add metricbridge-apple-health -- npx -y health-export-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "metricbridge-apple-health": {
            "command": "npx",
            "args": [
                "-y",
                "health-export-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "metricbridge-apple-health": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "health-export-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add metricbridge-apple-health npx -y health-export-mcp
```

## When to use it
- compare this week's HRV against last week
- track resting heart rate over a month
- break down sleep sessions by length
- pull workouts and VO₂ max into one report
- check whether a fresh iCloud export landed

## Example prompts
- Show how my resting heart rate changed over the past month.
- Use `get_mcp_status` to check when the latest data arrived.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md