# apple-health-mcp-server

Connects your Apple Health export to an AI agent through local or remote databases. Useful for checking activity metrics and pulse trends in chat.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 120 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/apple-health-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/apple-health-mcp-server

## What it does

This skill helps your agent run a FastMCP server for Apple Health exports. It stores records in DuckDB, ClickHouse, or Elasticsearch. Once imported, the assistant can filter records and calculate moving averages across your health metrics.

You need Python 3.10 and a raw `export.xml` file. Without that export, the server cannot start. Configuration is handled through environment variables or Docker.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/apple-health-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/apple-health-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/apple-health-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/apple-health-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/apple-health-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/apple-health-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/apple-health-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/apple-health-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/apple-health-mcp-server/SKILL.md

## When to use it
- parse Apple Health XML files into DuckDB or ClickHouse
- aggregate step counts and activity metrics by day or month
- filter health measurements by recording device or unit
- evaluate heart rate changes with moving average trends

## Example prompts
- Analyze the structure of my health export and summarize available types.
- Calculate my daily step statistics for last month.
- Check heart rate readings from the past week and look for trends.

## Similar
- [Apple Health](https://affpapa.org/en/nevibecode/mcp/apple-health.md) — MCP server · ★ 579 repo stars
- [MetricBridge Apple Health](https://affpapa.org/en/nevibecode/mcp/metricbridge-apple-health.md) — MCP server · ★ 11 repo stars
- [apple-health](https://affpapa.org/en/nevibecode/skills/apple-health.md) — skill · ★ 93 repo stars
- [health-data](https://affpapa.org/en/nevibecode/skills/health-data.md) — skill · 399 installs
- [elasticsearch-cluster-health](https://affpapa.org/en/nevibecode/skills/elasticsearch-cluster-health.md) — skill · 1500 installs
- [chdb-sql](https://affpapa.org/en/nevibecode/skills/chdb-sql.md) — skill · 10300 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

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