Apple Health
local MCP serverApple Health is a local MCP server: Local-first Apple Health MCP server for questions about your sleep, workouts and heart data. Install it from npm as @neiltron/apple-health-mcp.
Installation
Terminal
claude mcp add io-github-neiltron-apple-health-mcp -e HEALTH_DATA_DIR=... -e MAX_MEMORY_MB=... -e CACHE_SIZE=... -- npx -y @neiltron/apple-health-mcp
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"io-github-neiltron-apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp"
],
"env": {
"HEALTH_DATA_DIR": "...",
"MAX_MEMORY_MB": "...",
"CACHE_SIZE": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Node.js 18+ (runs with npx).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
HEALTH_DATA_DIR,MAX_MEMORY_MB,CACHE_SIZE
Summary
Local-first Apple Health MCP server for questions about your sleep, workouts and heart data.
Apple Health vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| Apple Health | 569 | Local | Yes | npm |
| google-health-mcp | 63 | Local | Yes | npm |
| whoop | 158 | Local | Yes | npm |
| Withings Health Data | 42 | Hosted | No | None |
| Polar Health Data (self-hosted) | 23 | Local | Yes | oci |
Questions
It reads 3 environment variables: HEALTH_DATA_DIR, MAX_MEMORY_MB, CACHE_SIZE. Set them in your MCP config before starting the server.
Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
Apple Health is a local MCP server distributed as the npm package @neiltron/apple-health-mcp.
Run: claude mcp add io-github-neiltron-apple-health-mcp -e HEALTH_DATA_DIR=... -e MAX_MEMORY_MB=... -e CACHE_SIZE=... -- npx -y @neiltron/apple-health-mcp
Run: codex mcp add io-github-neiltron-apple-health-mcp --env HEALTH_DATA_DIR=... --env MAX_MEMORY_MB=... --env CACHE_SIZE=... -- npx -y @neiltron/apple-health-mcp
Similar MCP servers
NameStars
- google-health-mcpio.github.davidmosiah/google-health-mcp63
- whoopio.github.shashankswe2020-ux/whoop158
- Withings Health Dataio.github.akutishevsky/withings42
- Polar Health Data (self-hosted)io.github.StuMason/polar-flow-server23
- samsung-health-mcpio.github.davidmosiah/samsung-health-mcp15
- whoop-mcpio.github.davidmosiah/whoop-mcp13
- wigoloio.github.KnockOutEZ/wigolo5,418
- Persomeio.github.Intuition-Lab/personal-model1,324