
Apple Health
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 toolsPublic 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: 2048Maximum memory usage in megabytes
CACHE_SIZEdefault: 100Maximum number of cached query results
Readme
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.
Requirements
- Node.js 22 or newer
- An Apple Health CSV export created with Simple Health Export CSV
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"
}
}
}
}
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