# 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 and
follow it. 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.

- [Setup skill (read this and follow it)](https://healthexport.dev/SKILL.md): self-contained Agent Skill with per-client config recipes 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.