davidmosiah avatar

Google Health Mcp

davidmosiah/google-health-mcp

Unofficial local-first server for Google's new Health API v4, which consolidates Fitbit, Pixel Watch, and partner health data under a single OAuth flow. Exposes read-only tools for identity, profile, settings, data point queries, reconciliation, and daily/weekly rollups across steps, sleep, heart rate, nutrition, and activity domains. The beta ships with a standalone doctor command for setup validation and scope presets that keep consent screens manageable. Tokens never leave your machine. Useful if you're building health agents that need to query reconciled streams from Google's ecosystem without pasting credentials into prompts. Author warns that Google may ship breaking changes before the official v4 launch in May 2026.

GitHub stars
81
tools
6
auth
Secret needed
transport
STDIO
env vars
8
last updated
Jul 13, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

google_health_connection_statusLocal config, token, scope and client readiness.

Local config, token, scope and client readiness.

No parameter schema in public metadata yet.

google_health_data_inventorySupported domains, scopes, data type naming and agent flow.

Supported domains, scopes, data type naming and agent flow.

No parameter schema in public metadata yet.

google_health_data_type_coverageStatic coverage plan, or explicit live read-only validation for issue #21.

Static coverage plan, or explicit live read-only validation for issue #21.

No parameter schema in public metadata yet.

google_health_daily_summaryDaily beta summary from rollups and reconciled streams.

Daily beta summary from rollups and reconciled streams.

No parameter schema in public metadata yet.

google_health_weekly_summaryWeekly beta review.

Weekly beta review.

No parameter schema in public metadata yet.

google_health_privacy_auditWhat is stored locally and what is sent to Google.

What is stored locally and what is sent to Google.

No parameter schema in public metadata yet.

Sponsors

Configuration

GOOGLE_HEALTH_CLIENT_ID

Google Cloud OAuth client ID for Google Health API. Optional when configured with google-health-mcp-server setup.

GOOGLE_HEALTH_CLIENT_SECRETsecret

Google Cloud OAuth client secret. Prefer google-health-mcp-server setup so this secret is stored in ~/.google-health-mcp/config.json instead of MCP client config.

GOOGLE_HEALTH_REDIRECT_URI

Redirect URI configured in the Google Cloud OAuth client. Optional when configured with google-health-mcp-server setup.

GOOGLE_HEALTH_TOKEN_PATH

Optional local path for OAuth tokens. Defaults to ~/.google-health-mcp/tokens.json.

GOOGLE_HEALTH_PRIVACY_MODE

Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full Google Health API payloads, not continuous 24/7 raw sensor telemetry.

GOOGLE_HEALTH_CACHE

Optional SQLite cache toggle. Set to true or sqlite to enable.

GOOGLE_HEALTH_CACHE_PATH

Optional local SQLite cache path. Defaults to ~/.google-health-mcp/cache.sqlite.

GOOGLE_HEALTH_NO_CACHE

Set to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless.

Readme

Google Health MCP

Google Health MCP — Google Health MCP for AI agents

Read user-authorized Google Health API v4 data — Fitbit, Pixel Watch and partners — locally via OAuth. Beta.
Local-first MCP server — tokens never leave your machine.


View the full README on GitHub

Details

Repository
github.com/davidmosiah/google-health-mcp
Website
wellness.delx.ai/connectors/google-health
Package
google-health-mcp-unofficial
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from davidmosiah