MCP server to query an exported Apple Health archive (export.zip) via SQLite.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"apple-health-export-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# apple-health-export-mcp [](https://github.com/burakdirin/apple-health-export-mcp/actions/workflows/ci.yml) [](https://pypi.org/project/apple-health-export-mcp/) [](https://pypi.org/project/apple-health-export-mcp/) [](LICENSE) An [MCP](https://modelcontextprotocol.io) server that lets an AI assistant query your **Apple Health** data — sleep, heart rate, steps, body mass, workouts, and any other metric in your export. Apple has no live export API, so this works on a **snapshot**: you export your health archive once, ingest it into a local SQLite database, then the server answers queries against it. See [`docs/adr.md`](docs/adr.md) for why. > **Privacy:** your health data never leaves your machine and is never committed to git (`.gitignore` excludes `*.zip` / `*.db`). ## How it works ``` export.zip ──(ingest, one-time ~1-3 min)──► health.db (SQLite) ──◄── MCP server queries ``` ## Setup 1. **Export your data** on iPhone: _Settings → Health → tap your photo → Export All Health Data_. AirDrop/save the resulting `export.zip`. 2. **Install** with [uv](https://docs.astral.sh/uv/). Installing once (rather than `uvx` on every launch) keeps the process tree shallow, which matters for clean shutdown — see [Shutdown & process model](#shutdown--process-model). ```bash uv tool install apple-health-export-mcp # …or from source: uv tool install git+https://github.com/burakdirin/apple-health-export-mcp ``` This puts two commands on your PATH: `apple-health-export-mcp` (the server) and `apple-health-export-mcp-ingest`. 3. **Ingest** the archive (one time per new export): ```bash AH_DB_PATH=~/.local/share/apple-health-export-mcp/health.db…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.