# Apple Health MCP (community) > Community MCP server, not by Apple: your agent answers questions about your sleep, workouts and heart data from a local Apple Health export. A community-built MCP server by Neil Pullman (neiltron). It isn't made by or affiliated with Apple. It lets your agent answer questions about your Apple Health data, such as sleep, workouts, activity and heart rate, by running SQL queries with DuckDB over a CSV export on your own computer. What you can do with it - See which tables, columns and units your export has (health_schema) - Run analytical queries, such as daily heart-rate averages, step totals or hours asleep (health_query) - Get a weekly, monthly or custom summary of heart rate, activity, sleep, workouts and calories (health_report) How it connects It runs on your machine with npx -y @neiltron/apple-health-mcp and needs Node.js 22 or newer. First export your data on your iPhone with the Simple Health Export CSV app, unzip it on your computer and set HEALTH_DATA_DIR to that folder. Apple's own export.xml format isn't supported. Optional settings are MAX_MEMORY_MB (default 2048) and CACHE_SIZE (default 100). Your health data - The server reads the files in place. It doesn't upload the export or make network requests, but query results go to your agent, which may send them to its model provider. - Every tool can reach your whole export history, so only use it with an agent you trust with that data. - The maker says its health reports summarize recorded data and are not medical advice. Good to know - It only reads your exported files; it can't change anything in Apple Health. - Several devices can record overlapping data, so totals may double-count unless a query splits them by source. - Run it from a local agent. The maker warns against exposing it to untrusted network clients. - Type: Plugin - Made by: neiltron - Category: Health & fitness - Formats: Local MCP - Version: 1.4.5 - Website: https://github.com/neiltron/apple-health-mcp - Source: https://github.com/neiltron/apple-health-mcp - Page: https://pluginboard.ai/plugins/apple-health-mcp ## Works with - Claude - GitHub Copilot - Cursor - Claude Code - Codex - Antigravity - Gemini CLI - OpenClaw - OpenCode - Hermes Agent ## Install You'll need: - `HEALTH_DATA_DIR` (required): Path to the Apple Health CSV export directory - `MAX_MEMORY_MB` (optional): Maximum memory usage in megabytes - `CACHE_SIZE` (optional): Maximum number of cached query results Replace each `` placeholder with your own value. ### Claude Add to claude_desktop_config.json: ```json { "mcpServers": { "apple-health-mcp-community": { "command": "npx", "args": [ "-y", "@neiltron/apple-health-mcp@1.4.5" ], "env": { "HEALTH_DATA_DIR": "" } } } } ``` ### GitHub Copilot Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22apple-health-mcp-community%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40neiltron%2Fapple-health-mcp%401.4.5%22%5D%2C%22env%22%3A%7B%22HEALTH_DATA_DIR%22%3A%22%3CHEALTH_DATA_DIR%3E%22%7D%7D Run in your terminal: ```shell code --add-mcp '{"name":"apple-health-mcp-community","command":"npx","args":["-y","@neiltron/apple-health-mcp@1.4.5"],"env":{"HEALTH_DATA_DIR":""}}' ``` Copilot CLI: ```shell copilot mcp add apple-health-mcp-community --env HEALTH_DATA_DIR= -- npx -y @neiltron/apple-health-mcp@1.4.5 ``` ### Cursor Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=apple-health-mcp-community&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBuZWlsdHJvbi9hcHBsZS1oZWFsdGgtbWNwQDEuNC41Il0sImVudiI6eyJIRUFMVEhfREFUQV9ESVIiOiI8SEVBTFRIX0RBVEFfRElSPiJ9fQ%3D%3D Add to .cursor/mcp.json: ```json { "mcpServers": { "apple-health-mcp-community": { "command": "npx", "args": [ "-y", "@neiltron/apple-health-mcp@1.4.5" ], "env": { "HEALTH_DATA_DIR": "" } } } } ``` ### Claude Code Run in your terminal: ```shell claude mcp add -e HEALTH_DATA_DIR= apple-health-mcp-community -- npx -y @neiltron/apple-health-mcp@1.4.5 ``` ### Codex Run in your terminal: ```shell codex mcp add --env HEALTH_DATA_DIR= apple-health-mcp-community -- npx -y @neiltron/apple-health-mcp@1.4.5 ``` ### Antigravity Add to ~/.gemini/config/mcp_config.json: ```json { "mcpServers": { "apple-health-mcp-community": { "command": "npx", "args": [ "-y", "@neiltron/apple-health-mcp@1.4.5" ], "env": { "HEALTH_DATA_DIR": "" } } } } ``` ### Gemini CLI Run in your terminal: ```shell gemini mcp add -e HEALTH_DATA_DIR= apple-health-mcp-community npx -y @neiltron/apple-health-mcp@1.4.5 ``` ### OpenClaw In a terminal: Run openclaw mcp add apple-health-mcp-community --command npx, with --arg before each argument (-y @neiltron/apple-health-mcp@1.4.5) and --env NAME=value for each variable it needs. ### OpenCode Run in your terminal: ```shell opencode mcp add apple-health-mcp-community --env HEALTH_DATA_DIR= -- npx -y @neiltron/apple-health-mcp@1.4.5 ``` ### Hermes Agent Add to ~/.hermes/config.yaml: ```json { "mcp_servers": { "apple-health-mcp-community": { "command": "npx", "args": [ "-y", "@neiltron/apple-health-mcp@1.4.5" ], "env": { "HEALTH_DATA_DIR": "" } } } } ``` --- From Pluginboard (https://pluginboard.ai).