davidmosiah/google-health-mcp

View on GitHub ↗

Local-first MCP server for Google Health API v4 (Fitbit + Pixel Watch) — Claude/Cursor/Hermes

43 ★7 forksTypeScriptUpdated 1mo ago

What you need to know

Local-first MCP server (beta, unofficial) that reads user-authorized Google Health API v4 data (Fitbit, Pixel Watch and partners) via OAuth. Tokens never leave your machine; structured privacy mode redacts identity, location and secret-bearing fields. CLI setup, auth and doctor commands, plus tools for daily/weekly summaries, data inventory, connection status and privacy audits.

Install

npx -y google-health-mcp-unofficial setup --scope-preset full
npx -y google-health-mcp-unofficial auth
npx -y google-health-mcp-unofficial doctor

Usage

  • •Check google_health_connection_status and google_health_data_inventory
  • •Call google_health_daily_summary / google_health_weekly_summary
  • •Run google_health_privacy_audit to review what is stored and sent
  • •Headless hosts: auth --manual, auth --print-url, auth --code

Key features

  • ✓Google Health API v4 data via OAuth (local-first, tokens at ~/.google-health-mcp/tokens.json with 0600 perms)
  • ✓Tools: connection_status, data_inventory, data_type_coverage, daily_summary, weekly_summary, privacy_audit
  • ✓Structured privacy mode with GPS key/container redaction and declared-limits tests
  • ✓CLI commands: setup, auth, doctor, coverage, support
  • ✓Hermes one-command setup via delx-wellness-hermes

Best for

AI agents that need personal health data summaries with strong local privacy controls

Caveats

  • ⚠Beta; Google Health API v4 still evolving
  • ⚠Unofficial project, not affiliated with Google/Fitbit/Alphabet; not a medical device
  • ⚠No per-user/per-tool RBAC; intended for one local user running one trusted MCP host
Platforms: macOS · Linux · WindowsClients: Claude · Cursor · ChatGPT · Hermes · OpenClaw
Documentation ↗

Reviewed 2026-08-11

Topics

agent-readyai-agent-toolsai-agentsanthropicclaudeclaude-desktopcursorfitbitgoogle-healthgoogle-health-apihealth-datalocal-firstmcpmcp-servermodel-context-protocoloauthpixel-watchtypescriptwearable-datawearables
Stars
43★
Forks
7
Language
TypeScript
License
MIT
Created
2026-05-07
Last push
2026-08-15