Apple Health MCP Server

Query Apple Health data from an MCP client using SQL and DuckDB. The server runs locally, reads CSV exports on demand, and provides tools for schema discovery, analytical queries, and health summaries. Its README documents 3 tools, including health_schema, health_query, health_report.

People who work with apple health, duckdb and quantified self and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-30 · ★ 570 · #15 OF 174 MAINTAINED DATABASE · VERIFIED 2026-09-30

MIT · TypeScript servers · how we verify → /methodology

01 · Install Apple Health

before you install - you'll need

HEALTH_DATA_DIR

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add neiltron-apple-health-mcp -- npx -y @neiltron/apple-health-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "neiltron-apple-health-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@neiltron/apple-health-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @neiltron/apple-health-mcp - published under the repo owner's npm scope (@neiltron)

registry namespace io.github.neiltron is GitHub-verified and matches the repo owner

03 · What Apple Health can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can discover table names, columns, units, and sample rows, run one DuckDB SELECT-family analytical statement with JSON, CSV, or summary output, and generate a weekly, monthly, or custom health summary.

The 3 tools it gives your agent

Extracted from the project's README - what Apple Health lets an agent do.

health_schema: - Discover table names, columns, units, and sample rows
health_query: - Run one DuckDB SELECT-family analytical statement with JSON, CSV, or summary output
health_report: - Generate a weekly, monthly, or custom health summary

Latest releases

v1.4.5 · 2026-09-20

Fixes · Return CSV directly instead of wrapping it in a JSON string. · Format CSV dates as ISO strings to match JSON output, independent of the server timezone. · Keep query checks while simplifying their…

v1.4.3 · 2026-09-19

Fold query table loading into TableLoader, drop QueryOptimizer · extract format importers behind a FormatImporter interface · enforce anti-slop rules and resolve findings · restore pre-lint behavior and emit valid CSV…

v1.4.1 · 2026-08-17

Fix silent row loss in the CSV loader. Column types are now inferred from the whole file, not a sample. (#23)

04 · Who maintains Apple Health

Apple Health is maintained by neiltron. It's the only MCP server we track from this author; the repo dates to Jul 2025.

05 · Facts

repository: github.com/neiltron/apple-health-mcp
website: https://github.com/neiltron/apple-health-mcp
category: database - ranked #15 of 174 actively-maintained database servers as of 2026-09-30.
release cadence: 6 releases in the last 90 days (latest 2026-09-20)
registry: io.github.neiltron/apple-health-mcp (active, first published 2026-08-06 · 4 versions)
packages: npm:@neiltron/apple-health-mcp

06 · Apple Health FAQ

Is Apple Health still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-30 and it shipped 6 releases in the last 90 days. We re-verify nightly.

What can Apple Health do?

How do I install Apple Health?

Run `npx -y @neiltron/apple-health-mcp`. The README documents one environment variable (HEALTH_DATA_DIR) to set first. You can also paste the ready-made client config above.

Does Apple Health run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Apple Health

Alternatives to Apple Health

Maintained database servers if Apple Health isn't the fit.

Pairs well with

Servers that cover what Apple Health doesn't - only shown when the pairing reason fits the companion.

More database MCP servers · Neo4j Aura Manager · Neo4j Cypher · Neon · db-MCP (SQLite MCP Server) · MySQL MCP

More TypeScript MCP servers · Figma Edit MCP · Dispatch SEO · Heor Agent · Rubber Duck · see all