Two paths
File drop or agent access
1. Export a file, drop it in
Export the metrics and date range you want as CSV or JSON, then attach the file to a Claude Project, a ChatGPT conversation, or your Codex session. The assistant analyzes exactly what you gave it — nothing more.
2. Let an agent ask directly
Health.md for Mac ships a signed healthmd-mcp helper. Codex, Claude, and other MCP hosts use it to run scoped queries — metric charts, sleep sessions, workouts, coverage — and get back factual answers with units, evidence, and explicit missingness instead of guesses.
File export works from the iPhone app alone. The MCP path needs Health.md for Mac open with your iPhone connected, plus a local MCP host. Read the MCP setup guide
Per assistant
Setup notes
Claude
Add the healthmd-mcp helper to Claude Desktop's MCP configuration or a Claude Code .mcp.json. Hosts that support MCP Apps render Health.md's interactive charts inline; text-first clients get exact JSON with image fallbacks.
Codex
Register the helper under mcp_servers.healthmd in ~/.codex/config.toml, restart Codex, then run healthmd_doctor and list metrics with healthmd_metrics. Export and refresh tools stay approval-gated.
ChatGPT
Use the file path: export a CSV or JSON of the metrics and dates you want analyzed, then upload or attach it to your conversation. You decide the scope by choosing what to export.
Privacy
Scoped by default
Every request carries its own scope. An agent can only ask about what you approve — queries return bounded pages with coverage, missing intervals, and limitations spelled out, so nothing is silently extrapolated.
Generated-file writes are approval-gated operations, and Health.md reports factual observations only: units, provenance, coverage, missingness. It does not diagnose or recommend treatment — and there is no Health.md health-data cloud in the loop.
Keep going
From data to answers
Get the file first
CSV, JSON, Markdown, or Obsidian — export exactly what you want the AI to see. Export Apple Health data
Just need CSV?
The spreadsheet-ready path for Excel, Google Sheets, and AI uploads. Apple Health to CSV
Developer docs
MCP tools, agent architecture, typed queries, and contracts. Local agents documentation
Common questions
Frequently asked questions
Which AI assistants work with Health.md?
Claude and Codex can query Health.md directly through its MCP server. Any assistant — including ChatGPT — can analyze exported CSV or JSON files you provide.
Do I need the Mac app to use MCP?
For the bundled MCP helper, yes: Health.md for Mac ships a signed healthmd-mcp helper, and it works while the Mac app is open with your iPhone connected. File exports work from the iPhone app alone.
Does the agent see all of my health data?
No. Every request carries its own scope — you approve what the agent may ask about, and queries return bounded results with explicit coverage and missingness.
Can Health.md or the AI diagnose me?
No. Health.md reports factual observations with units, provenance, and coverage. It does not diagnose, recommend treatment, or provide medical advice.
Is my health data sent to Health.md's servers for AI use?
No. Health.md is local-first and keeps no health-data cloud. Your records go only to the destinations and clients you choose.