neiltron avatar

Apple Health

neiltron/apple-health-mcp

The Apple Health MCP server enables users to query their Apple Health data using SQL through DuckDB, powered by a natural language interface. It provides tools for executing SQL queries, generating automated health reports, and caching results efficiently, while supporting lazy loading of configurable time windows. The server solves the problem of accessing and analyzing Apple Health data by accepting CSV exports from the Simple Health Export app and making that data queryable through standard SQL syntax.

GitHub stars
575
tools
3
auth
Required
transport
STDIO
env vars
3
last updated
Sep 20, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

health_schemaDiscover table names, columns, units, and sample rows

Discover table names, columns, units, and sample rows

No parameter schema in public metadata yet.

health_queryRun one DuckDB SELECT-family analytical statement with JSON, CSV, or summary output

Run one DuckDB SELECT-family analytical statement with JSON, CSV, or summary output

No parameter schema in public metadata yet.

health_reportGenerate a weekly, monthly, or custom health summary

Generate a weekly, monthly, or custom health summary

No parameter schema in public metadata yet.

Sponsors

Configuration

HEALTH_DATA_DIR*

Path to the Apple Health CSV export directory

MAX_MEMORY_MBdefault: 2048

Maximum memory usage in megabytes

CACHE_SIZEdefault: 100

Maximum number of cached query results

Readme

Apple Health MCP Server

npm version License: MIT

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.

Requirements

The native Apple Health export.xml format is not currently supported.

Configure an MCP client

For Claude Desktop, add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": ["-y", "@neiltron/apple-health-mcp"],
      "env": {
        "HEALTH_DATA_DIR": "/path/to/your/unzipped/health-export"
      }
    }
  }
}

View the full README on GitHub

Details

Repository
github.com/neiltron/apple-health-mcp
Website
github.com/neiltron/apple-health-mcp
Category
Data & Analytics
Package
@neiltron/apple-health-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1billy-enrizky avatarOpenbrowser Aibilly-enrizky/openbrowser-aiAI browser automation. Write async Python to navigate, click, type, and extract data.279stars
2s-stefanov avatarActual Budget MCP Servers-stefanov/actual-mcpMCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.279stars
3isaacphi avatarGoogle Driveisaacphi/mcp-gdriveModel Context Protocol (MCP) Server for reading from Google Drive and editing Google Sheets276stars
4jgravelle avatarjDocmunch MCPjgravelle/jdocmunch-mcpSection-level doc search for .md, .rst, .adoc, .org, .ipynb, .html, .yaml, .json, and OpenAPI specs.206stars
5tapetide-hq avatarTapetide - Indian Stock Market MCPtapetide-hq/nse-bse-indian-stock-market-data-mcp48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options0stars
6benseverndev-oss avatarGoldenAnalysisbenseverndev-oss/goldenmatchRead-only cross-cutting analysis, metrics, and reporting across the Golden Suite.0stars