Apple Health MCP Server
MCP server for Apple Health data: an agent answers questions about sleep, workouts and heart rate with SQL
- 575 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads sensitive personal health data
- Query results are sent to your MCP client's model
- Runs generated SQL queries over your export
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/apple-health-mcp-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads sensitive personal health data
- Query results are sent to your MCP client's model
- Runs generated SQL queries over your export
This is third-party code. Review the repository files before installing.
What it does
The server works locally with an Apple Health CSV export and runs queries through DuckDB. It shows the table schema, columns and units, runs one analytical SELECT statement with output as JSON, CSV or a summary, and builds a weekly, monthly or custom health report. Data is read in place: the server does not upload the export or make network calls, though results returned to the client go to its model. File access is limited to the specified data directory.
Who it is for. For people who export Apple Health data and want to analyze sleep, activity and heart rate with queries.
Good fit when
- You want answers about your health data over a period
- You need a summary or report on sleep, workouts and activity
- You want to analyze Apple Health data with SQL without manual spreadsheets
Not a fit when
- You have no Apple Health CSV export from the required app
- You need medical conclusions; the reports do not replace a doctor
Example request
Show how my sleep changed over the last month and build a short reportMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
HEALTH_DATA_DIRrequired- Path to the folder with the unzipped Apple Health CSV export
MAX_MEMORY_MB- DuckDB memory limit in megabytes, default 2048
CACHE_SIZE- Maximum number of cached query results
Limitations
You need an Apple Health CSV export from the Simple Health Export CSV app; the native export.xml format is not yet supported. You point HEALTH_DATA_DIR at the unzipped export directory, and Node.js 22 or newer is required. The DuckDB database is held in memory and rebuilt on each launch, with the memory limit set via MAX_MEMORY_MB. The server runs one SELECT statement at a time, and health reports are not medical advice.
How to disable. Remove the apple-health block from your MCP client config and restart it. Your data stays in the export folder and is not copied anywhere.
FAQ
How do I export the data?
With the Simple Health Export CSV app on iPhone: pick the period, move the archive to the computer, unzip it and point HEALTH_DATA_DIR at the folder.
Does data go to the network?
The server itself makes no network calls and does not upload the export. But query results it returns to the client are sent to that client's model.
Discussion
No questions or reviews yet.
Related
MCP serversOne MCP server for SQLite, SQL Server, PostgreSQL and MySQL: read and change data, edit schemas and export to CSV and JSON
DuckDB / MotherDuck MCP Server
DuckDB / MotherDuck Local MCP Server
An MCP server for SQL analytics on DuckDB: local files, in-memory databases, S3-hosted databases and MotherDuck
Official Apache IoTDB MCP server: SQL over time series in tree and table models, with CSV and Excel export
MySQL MCP Server Pro
mysql_mcp_server_pro
A MySQL MCP server that runs SQL under access roles, finds tables by comments and analyzes locks, indexes and query plans
A lightweight database workspace with an MCP server: the agent reads the schema, runs queries and explores data in PostgreSQL, MySQL and more
An agent queries GreptimeDB metrics, logs and traces with SQL, TQL and RANGE, with write protection and data masking
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Apple Health MCP Server (this card) | no | not required | 575 | |
| kubectl-mcp-server | no | not required | 972 | reads cluster state and diagnoses pod failures |
| Unreal Engine MCP Server | no | not required | 1,033 | Unreal Engine assets, actors and blueprints |
| Android MCP | no | not required | 924 | controls an Android device through ADB |
README in short
The README describes a local server that reads an Apple Health CSV export and runs queries through DuckDB. It lists the tools health_schema, health_query and health_report and Claude Desktop setup via npx with the HEALTH_DATA_DIR variable. It details requirements: Node.js 22 and an export from the Simple Health Export CSV app, plus file access limits and disabled network inside DuckDB. It notes the database is in memory and rebuilt on each launch and that reports are not medical advice. MIT licensed.