Health Analyzer MCP Server

MCP server that connects OpenClaw (or other MCP clients) to Health Data AI Analyzer.

Requirements

• Health Data AI Analyzer app (macOS)
• Node.js 18+
• An MCP client (OpenClaw, Claude Desktop, etc.)

Installation

npm install -g health-analyzer-mcp

Or install from source:

cd mcp-server
npm install
npm link

Configuration

Add to your MCP client config (e.g., OpenClaw or Claude Desktop):

{
  "mcpServers": {
    "health-analyzer": {
      "command": "health-analyzer-mcp"
    }
  }
}

For OpenClaw workspace skills, you can also keep the skill folder from this repo in your workspace:

skills/health-analyzer-mac-local/

That skill assumes this MCP server is installed and available as health-analyzer-mcp.

Usage

1. Open Health Data AI Analyzer and load your health data
2. Start your MCP client
3. Ask questions like:
   • "Give me my daily health brief"
   • "How many steps did I take last week?"
   • "What's my average sleep duration?"
   • "Show me my heart rate trends"
   • "How many workouts did I do this month?"

The MCP server reads the local API token automatically from:

~/Library/Application Support/Health Data AI Analyzer/local-api-token.txt

For the sandboxed App Store build, it will also search the container path automatically, for example:

~/Library/Containers/com.rumjahn.healthkitanalyzer/Data/Library/Application Support/Health Data AI Analyzer/local-api-token.txt

You can override it with:

HEALTH_ANALYZER_TOKEN=...
HEALTH_ANALYZER_TOKEN_FILE=/absolute/path/to/local-api-token.txt

Available Tools

| Tool | Description | |------|-------------| | get_status | Check whether the local API is running and a dataset is loaded | | list_metrics | Check what health data is loaded | | get_health_summary | Overview of all metrics | | get_daily_health_brief | Daily overview with sleep, steps, workouts, and recovery context | | get_steps | Step counts and averages | | get_sleep | Sleep duration and stages | | get_heart_rate | Heart rate, resting HR, and HRV trends | | get_hrv | Heart rate variability | | get_weight | Weight measurements | | get_workouts | Workout history | | get_vo2max | VO2 max fitness level |

Troubleshooting

"Cannot connect to Health Data AI Analyzer"

• Make sure the Mac app is running
• Make sure you have health data loaded in the app
• Open the Mac app Settings and confirm the Local API section shows Running
• If needed, set HEALTH_ANALYZER_TOKEN_FILE to the token file path shown in app Settings

Tools not showing up

• Restart your MCP client after adding the config
• Check that health-analyzer-mcp is in your PATH