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, read-only queries, and health summaries. Its README documents 3 tools, including health_schema, health_query, health_report.

People connecting database tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 563 · #9 OF 151 MAINTAINED DATABASE · VERIFIED 2026-08-25

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 a read-only SELECT query 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 a read-only SELECT query with JSON, CSV, or summary output
health_report: - Generate a weekly, monthly, or custom health summary

Latest releases

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)

v1.4.0 · 2026-08-16

Add prompt templates: weekly_summary, sleep_analysis, and workout_progress. · Add resources: health://schema and health://tables. · Start the server when the data directory is missing or empty. Write a warning to…

v1.3.0 · 2026-08-15

Changes · The server loads the full history of each CSV file. The 90-day window is removed. A two-year export is fully queryable. · The loader reads each CSV in one pass. This lowers peak memory. A 6,000,000-row export…

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 #9 of 151 actively-maintained database servers as of 2026-08-25.
release cadence: 4 releases in the last 90 days (latest 2026-08-17)
registry: io.github.neiltron/apple-health-mcp (active, first published 2026-08-06 · 2 versions)
packages: npm:@neiltron/apple-health-mcp

06 · Apple Health FAQ

Is Apple Health still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24 and it shipped 4 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 · db-MCP (SQLite MCP Server) · MySQL MCP · PostgreSQL MCP Server

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