Health MCP Server

Query 190 Apple Health metrics from any MCP agent — zero-dependency, read-only, local-first.

Remote serverstreamable-http

What is the Health MCP Server?

Query 190 Apple Health metrics from any MCP agent — zero-dependency, read-only, local-first.

What you get

It's an MCP server that turns your Apple Health export into a tool your AI agent can query in natural language — HRV, sleep, resting heart rate, steps, workouts, VO₂ max, and 180+ more.

Configuration and credentials

  • Node.js ≥ 18 (node -v). - A folder containing a .health-cache.json exported by Health Export AI — or run npm test to generate a sample one. - An MCP-compatible client (Claude Desktop, Cursor, opencode, OpenClaw, Hermes, VS Code) — or any tool that can read the webhook export. ---

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_mcp_statusHealth check — source, metric/workout counts, latest data date. **Call first.**
list_metricsEvery available metric with unit, day count, and date range.
get_health_metricsDaily values for a metric (or all) over a date range + an aggregate (avg/sum/min/max/latest).
get_trendsRecent N-day window vs the prior N days — change, % change, direction.
compare_periodsA metric across two arbitrary date periods (A vs B).
get_structured_exportClean JSON for chosen metrics/range — drop straight into context.
query_health_dataNatural-language convenience: *"average HRV last month"* → routed structured results.

How to install the Health MCP Server

{
  "mcpServers": {
    "health-export": {
      "command": "npx",
      "args": [
        "-y",
        "health-export-mcp"
      ],
      "env": {
        "HEALTH_DATA_DIR": "~/Library/Mobile Documents/iCloud~ai~healthexport~app/Documents"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js ≥ 18 (node -v). - A folder containing a .health-cache.json exported by Health Export AI — or run npm test to generate a sample one. - An MCP-compatible client (Claude Desktop, Cursor, opencode, OpenClaw, Hermes, VS Code) — or any tool that can read the webhook export. ---
VariableDescriptionRequired
HEALTH_DATA_DIRDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Health to get mcp status.”
  • “Use Health to list metrics.”
  • “Use Health to get health metrics.”

Frequently asked questions

Query 190 Apple Health metrics from any MCP agent — zero-dependency, read-only, local-first. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.