Apple Health MCP Server

by krumjahnio.github.krumjahn/health-analyzer-mcpv1.1.2

Apple Health data for AI agents — expose your Apple Health / HealthKit data to Claude, Cursor, and other MCP clients via the Health Data AI Analyzer Mac app. All data stays local.

Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Apple Health MCP server

claude mcp add krumjahn -e HEALTH_ANALYZER_TOKEN='<health-analyzer-token>' -- npx -y health-analyzer-mcp

{
  "mcpServers": {
    "krumjahn": {
      "command": "npx",
      "args": [
        "-y",
        "health-analyzer-mcp"
      ],
      "env": {
        "HEALTH_ANALYZER_TOKEN": "<health-analyzer-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "krumjahn": {
      "command": "npx",
      "args": [
        "-y",
        "health-analyzer-mcp"
      ],
      "env": {
        "HEALTH_ANALYZER_TOKEN": "<health-analyzer-token>"
      }
    }
  }
}

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

{
  "servers": {
    "krumjahn": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "health-analyzer-mcp"
      ],
      "env": {
        "HEALTH_ANALYZER_TOKEN": "<health-analyzer-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "krumjahn": {
      "command": "npx",
      "args": [
        "-y",
        "health-analyzer-mcp"
      ],
      "env": {
        "HEALTH_ANALYZER_TOKEN": "<health-analyzer-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
HEALTH_ANALYZER_TOKEN	—	yes	Optional. Overrides token auto-discovery. The token is generated by the Health Data AI Analyzer Mac app and normally read automatically from its sandboxed container; only set this if auto-discovery fails.
HEALTH_ANALYZER_TOKEN_FILE	—	—	Optional. Absolute path to the local-api-token.txt file written by the Mac app. The server searches default sandbox paths automatically; only set this if auto-discovery fails.

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-01 · 2mo ago · official registry · v1.1.2

FAQ

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

Run: claude mcp add krumjahn -e HEALTH_ANALYZER_TOKEN='<health-analyzer-token>' -- npx -y health-analyzer-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_ANALYZER_TOKEN, of which 1 is a secret.

›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.krumjahn/health-analyzer-mcp.