Apple Health MCP Server

by neiltronio.github.neiltron/apple-health-mcpv1.4.5

Local-first Apple Health MCP server for questions about your sleep, workouts and heart data.

571Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active7d ago

Install Apple Health MCP server

claude mcp add apple-health -e HEALTH_DATA_DIR='<health-data-dir>' -- npx -y @neiltron/apple-health-mcp

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": [
        "-y",
        "@neiltron/apple-health-mcp"
      ],
      "env": {
        "HEALTH_DATA_DIR": "<health-data-dir>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": [
        "-y",
        "@neiltron/apple-health-mcp"
      ],
      "env": {
        "HEALTH_DATA_DIR": "<health-data-dir>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "apple-health": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@neiltron/apple-health-mcp"
      ],
      "env": {
        "HEALTH_DATA_DIR": "<health-data-dir>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": [
        "-y",
        "@neiltron/apple-health-mcp"
      ],
      "env": {
        "HEALTH_DATA_DIR": "<health-data-dir>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
HEALTH_DATA_DIR	yes	—	Path to the Apple Health CSV export directory
MAX_MEMORY_MB	—	—	Maximum memory usage in megabytes
CACHE_SIZE	—	—	Maximum number of cached query results

Freshness

Active — last maintenance signal 7d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-02 · 7d ago · GitHub
Latest release
2026-09-20 · 19d ago · GitHub · v1.4.5
Package published
no data · npm/PyPI
Registry entry updated
2026-09-20 · 19d ago · official registry · v1.4.5

FAQ

›How do I install the Apple Health MCP server in Claude Code?

Run: claude mcp add apple-health -e HEALTH_DATA_DIR='<health-data-dir>' -- npx -y @neiltron/apple-health-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Apple Health require an API key?

Yes. It expects HEALTH_DATA_DIR.

›Can I use Apple Health as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Apple Health in the official MCP registry?

Yes, as io.github.neiltron/apple-health-mcp.