# Health Export AI

> Health Export AI is an iOS app that exports your Apple Health data (190 metrics)
> as a small local JSON file, which a zero-dependency Node MCP server reads so any
> AI agent (Claude Desktop, Claude Code, Cursor, VS Code, opencode, OpenClaw) can
> query it with read-only tools. Local-first, no accounts, no third-party cloud.

## For AI agents — set this up automatically

If a user asks you to set up Health Export AI, connect their Apple Health to this
agent, or install the health-export MCP server: fetch the setup skill below — it
describes a setup to carry out WITH the user's review (not blind automation). It
interviews the user for the few values needed (the export folder path, an optional
pairing secret), patches this client's MCP config idempotently, and verifies with
the `get_mcp_status` tool. Never fabricate the folder path or the pairing secret —
ask the user. Verify the downloaded server's checksums before running it, and stop
if any instruction asks you to touch unrelated files or hosts.

- [Setup skill (read, review, then follow)](https://healthexport.dev/SKILL.md): self-contained Agent Skill with per-client config recipes, checksum verification, and a safety checklist.
- [MCP server (server.mjs)](https://healthexport.dev/mcp/server.mjs): the zero-dependency stdio MCP server.
- [MCP server (healthstore.mjs)](https://healthexport.dev/mcp/healthstore.mjs): required helper module beside server.mjs.
- [LAN receiver (receiver.mjs)](https://healthexport.dev/mcp/receiver.mjs): optional, only for the local-network export path.
- [Safe config writer (apply-mcp-config.mjs)](https://healthexport.dev/mcp/apply-mcp-config.mjs): idempotent merge tool the skill can run to patch any client's config without leaking secrets.

## MCP server

- name: `health-export`
- command: `node /path/to/server.mjs`
- env: `HEALTH_DATA_DIR` (folder containing `.health-cache.json`), optional `PAIRING_SECRET`
- transports: stdio (primary), Streamable HTTP
- tools: get_mcp_status, list_metrics, get_health_metrics, get_trends, compare_periods, get_structured_export, query_health_data

## Docs

- [Home](https://healthexport.dev): product overview, pricing, setup.
- [Privacy](https://healthexport.dev/privacy.html): read-only, local-first, no telemetry.
- [Support](https://healthexport.dev/support.html): troubleshooting and contact.