This server lets AI agents securely read user-authorized Google Health API v4 data (Fitbit, Pixel Watch, partners) locally via OAuth, with tokens never leaving your machine.

Authentication & Setup

• Generate an OAuth URL (google_health_get_auth_url), exchange codes for tokens (google_health_exchange_code) stored locally with 0600 permissions, and revoke access (google_health_revoke_access).

Health Data Access

• List data points (google_health_list_data_points) — query steps, sleep, heart rate, weight, exercise, etc.

• Reconcile data streams (google_health_reconcile_data_points) — merge streams across all-sources, google-wearables, or google-sources.

• Daily rollup (google_health_daily_rollup) — aggregate data over civil days.

• Physical-time rollup (google_health_rollup) — aggregate over arbitrary time intervals.

User Profile & Identity

• Retrieve identity (google_health_get_identity), profile (google_health_get_profile), and settings like units/timezone (google_health_get_settings).

Summaries & Reports

• Daily summary (google_health_daily_summary) and weekly summary (google_health_weekly_summary) for aggregated health metrics.

• Wellness context (google_health_wellness_context) — normalize health data into a standardized shape for recommendation engines, including soreness/injury flags.

Discovery & Diagnostics

• Connection status (google_health_connection_status) — check config, token file, privacy mode, and scope readiness.

• Data inventory (google_health_data_inventory) and capabilities (google_health_capabilities) — explore supported types, scopes, and recommended workflows.

• Agent manifest (google_health_agent_manifest) — machine-readable install/runtime guide for AI agents.

• Cache status (google_health_cache_status) — inspect optional local SQLite cache.

• Privacy audit (google_health_privacy_audit) — review privacy posture without exposing secrets.

Privacy & Security

• Three privacy modes: summary, structured (default), and raw.

• Tokens stored at ~/.google-health-mcp/tokens.json; access tokens, refresh tokens, and client secrets are never returned to the agent.

• GPS redaction enabled by default.

Allows access to health data from Android devices like Pixel Watch via the Google Health API, including activity, sleep, and health metrics.

Enables reading user-authorized health data from Fitbit devices through the Google Health API, such as steps, sleep, heart rate, and exercise.

Provides tools to read authorized health data from the Google Health API v4, including data from Fitbit, Pixel Watch, and other supported sources.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Google Health MCP show my daily summary for yesterday"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.

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

http://127.0.0.1:3000/callback

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

npx -y google-health-mcp-unofficial setup --scope-preset basic
npx -y google-health-mcp-unofficial setup --scope-preset activity
npx -y google-health-mcp-unofficial setup --scope-preset sleep
npx -y google-health-mcp-unofficial setup --scope-preset full

npx -y google-health-mcp-unofficial doctor --fix
npx -y google-health-mcp-unofficial doctor --live
npx -y google-health-mcp-unofficial support --redacted

https://www.googleapis.com/auth/googlehealth.profile.readonly
https://www.googleapis.com/auth/googlehealth.settings.readonly
https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
https://www.googleapis.com/auth/googlehealth.sleep.readonly
https://www.googleapis.com/auth/googlehealth.nutrition.readonly

{
 "mcpServers": {
 "google_health": {
 "command": "npx",
 "args": ["-y", "google-health-mcp-unofficial"]
 }
 }
}

steps
sleep
heart-rate
daily-resting-heart-rate
daily-heart-rate-variability
active-zone-minutes
total-calories
weight
exercise

steps.interval.civil_start_time >= "2026-05-07"
heart_rate.sample_time.physical_time >= "2026-05-07T00:00:00Z"
sleep.interval.civil_start_time >= "2026-05-07"

users/me/dataSourceFamilies/all-sources
users/me/dataSourceFamilies/google-wearables
users/me/dataSourceFamilies/google-sources

npx -y google-health-mcp-unofficial setup --client hermes --no-auth
npx -y google-health-mcp-unofficial auth
npx -y google-health-mcp-unofficial doctor --client hermes --fix
npx -y google-health-mcp-unofficial doctor --client hermes --live
hermes mcp test google_health

git clone https://github.com/davidmosiah/google-health-mcp.git
cd google-health-mcp
npm install
npm test