{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_48x5wd5f5qxc","handle":"apple-health-export-mcp","url":"https://wellknown.network/agents/apple-health-export-mcp","links":{"self":"https://wellknown.network/agents/apple-health-export-mcp/record.json","html":"https://wellknown.network/agents/apple-health-export-mcp","markdown":"https://wellknown.network/agents/apple-health-export-mcp/record.md","api":"https://wellknown.network/api/v1/agents/apple-health-export-mcp","status":"https://wellknown.network/api/v1/agents/apple-health-export-mcp/status","claim":"https://wellknown.network/agents/apple-health-export-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/apple-health-export-mcp/claim.json","badge":"https://wellknown.network/agents/apple-health-export-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:apple-health-export-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"apple-health-export-mcp","summary":"MCP server to query an exported Apple Health archive (export.zip) via SQLite.","description":"# apple-health-export-mcp\n\n[![CI](https://github.com/burakdirin/apple-health-export-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/burakdirin/apple-health-export-mcp/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/apple-health-export-mcp.svg)](https://pypi.org/project/apple-health-export-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/apple-health-export-mcp.svg)](https://pypi.org/project/apple-health-export-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\nAn [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.\n\nApple 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.\n\n> **Privacy:** your health data never leaves your machine and is never committed to git (`.gitignore` excludes `*.zip` / `*.db`).\n\n## How it works\n\n```\nexport.zip ──(ingest, one-time ~1-3 min)──► health.db (SQLite) ──◄── MCP server queries\n```\n\n## Setup\n\n1. **Export your data** on iPhone: _Settings → Health → tap your photo → Export All Health Data_. AirDrop/save the resulting `export.zip`.\n\n2. **Install** with [uv](https://docs.astral.sh/uv/). Installing once (rather than\n   `uvx` on every launch) keeps the process tree shallow, which matters for clean\n   shutdown — see [Shutdown & process model](#shutdown--process-model).\n\n   ```bash\n   uv tool install apple-health-export-mcp\n   # …or from source:\n   uv tool install git+https://github.com/burakdirin/apple-health-export-mcp\n   ```\n\n   This puts two commands on your PATH: `apple-health-export-mcp` (the server) and\n   `apple-health-export-mcp-ingest`.\n\n3. **Ingest** the archive (one time per new export):\n\n   ```bash\n   AH_DB_PATH=~/.local/share/apple-health-export-mcp/health.db…","publisher":{"name":"Burak Dirin","url":null},"homepage":"https://github.com/burakdirin/apple-health-export-mcp","repository":"https://github.com/burakdirin/apple-health-export-mcp/blob/main/CHANGELOG.md","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["apple-health","fastmcp","healthkit","mcp","quantified-self"],"pricing":null,"endpoints":[{"url":"pypi:apple-health-export-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"apple-health-export-mcp","registry":"pypi","observedAt":"2026-09-09T09:24:57.503Z","publishedAt":"2026-06-30T20:15:38.955940Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"apple-health-export-mcp","url":"https://pypi.org/project/apple-health-export-mcp/","firstSeenAt":"2026-09-09T09:23:16.750Z","fetchedAt":"2026-09-09T09:23:16.750Z","normalizedAt":"2026-09-09T09:23:16.750Z"}]},"firstSeenAt":"2026-09-09T09:23:16.750Z","updatedAt":"2026-09-09T09:24:57.503Z"}