{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3n87uaxgvfm3","handle":"apple-health-mcp","url":"https://wellknown.network/agents/apple-health-mcp","links":{"self":"https://wellknown.network/agents/apple-health-mcp/record.json","html":"https://wellknown.network/agents/apple-health-mcp","markdown":"https://wellknown.network/agents/apple-health-mcp/record.md","api":"https://wellknown.network/api/v1/agents/apple-health-mcp","status":"https://wellknown.network/api/v1/agents/apple-health-mcp/status","claim":"https://wellknown.network/agents/apple-health-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/apple-health-mcp/claim.json","badge":"https://wellknown.network/agents/apple-health-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/apple-health-mcp/history","tools":"https://wellknown.network/api/v1/agents/apple-health-mcp/tools"},"ard":{"identifier":"urn:air::server:apple-health-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"apple-health-mcp","summary":"MCP server that lets LLMs query your Apple Health export via SQL","description":"# apple-health-mcp\n\nMCP server that loads your Apple Health export into an in-memory SQLite database and exposes it to LLMs via the [Model Context Protocol](https://modelcontextprotocol.io/).\n\n## Quick start\n\n```bash\nuvx apple-health-mcp --input ~/Downloads/export.zip\n```\n\nOr install it permanently:\n\n```bash\nuv tool install apple-health-mcp\napple-health-mcp --input ~/Downloads/export.zip\n```\n\n## Exporting your data from Apple Health\n\n1. Open the **Health** app on your iPhone\n2. Tap your profile picture (top-right)\n3. Scroll down and tap **Export All Health Data**\n4. Confirm — this may take a few minutes\n5. Save or AirDrop the resulting `export.zip` to your Mac\n\n## Claude Desktop integration\n\nAdd this to your `claude_desktop_config.json`\n(macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"apple-health\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"apple-health-mcp\",\n        \"--input\",\n        \"/absolute/path/to/export.zip\"\n      ]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The tools will appear in the tools menu.\n\n## MCP tools\n\n### `list_metrics()`\n\nReturns every distinct record type and its count.\n\n### `list_workout_types()`\n\nReturns every distinct workout activity type and its count.\n\n### `summary(metric, period)`\n\nAggregates a metric by `day`, `week`, or `month`. Returns count, avg, min, max, and sum.\n\n```\nsummary(\"StepCount\", \"week\")\nsummary(\"HeartRate\", \"month\")\n```\n\n### `query(sql)`\n\nRun arbitrary read-only SQL against the database. Only `SELECT` statements are allowed.\n\n**Schema:**\n\n```sql\nrecords(type, source_name, unit, value, start_date, end_date)\nworkouts(activity_type, source_name, duration, duration_unit,\n         total_energy_kcal, total_distance, distance_unit, start_date, end_date)\n```\n\n**Examples:**\n\n```sql\n-- Daily step totals for the last 30 days\nSELECT substr(start_date, 1, 10) AS day, sum(CAST(value AS REAL)) AS steps\nFROM records WHERE type = 'StepCount'\nGROUP BY day ORDER BY day DES…","publisher":null,"homepage":"https://github.com/smarzola/apple-health-mcp","repository":"https://github.com/smarzola/apple-health-mcp","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["apple-health","claude","healthkit","llm","mcp"],"pricing":null,"endpoints":[{"url":"pypi:apple-health-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"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"}],"categories":["data"],"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-mcp","registry":"pypi","observedAt":"2026-11-08T23:27:25.679Z","publishedAt":"2026-03-22T22:21:46.160172Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"apple-health-mcp","url":"https://pypi.org/project/apple-health-mcp/","firstSeenAt":"2026-09-09T09:23:16.990Z","fetchedAt":"2026-11-08T23:26:15.927Z","normalizedAt":"2026-11-08T23:26:15.927Z"}]},"firstSeenAt":"2026-09-09T09:23:16.990Z","updatedAt":"2026-11-08T23:27:25.679Z"}