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 20d 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