partymola/google-health-mcp

MCP server for the Google Health API, with a local SQLite cache and trend analysis.
Designed for Claude Code and other MCP clients. Your data syncs to a database on your own machine, so queries are fast, work offline, and cost no API quota.
Features
- **Local SQLite cache** - sync once, query instantly
- **Incremental sync** - each run fetches only what is new, resuming from where the last one stopped
- **Offline mode** - serve the cache with no credentials and no network at all
- **Trends** - weekly, monthly or quarterly aggregates, and two-period comparisons
- **ECG** - readings stored whole, waveform included, returned only when asked for
- **doctor** - diagnoses a setup offline and read-only, without spending quota
Data types
| Tool | Data |
|------|------|
| health_get_heart_rate | Resting heart rate |
| health_get_activity | Steps, calories, distance, floors |
| health_get_exercises | Workouts: name, duration, heart rate, calories, Google's metrics summary, and splits on request |
| health_get_exercise_route | One workout's GPS route, as the TCX file Google exports |
| health_get_sleep | Duration, stages, sleep period |
| health_get_sleep_sessions | Each session as Google recorded it: metadata, summary, and every stage segment on request |
| health_get_weight | Weight, body fat %, one row a day |
| health_get_weight_readings | Every weigh-in and body-fat reading, as Google recorded each one |
| health_get_height | Height readings |
| health_get_spo2 | Nightly blood oxygen saturation |
| health_get_hrv | Heart rate variability (RMSSD) |
| health_get_azm | Active zone minutes, with the per-zone breakdown |
| health_get_breathing_rate | Nightly breaths per minute |
| health_get_skin_temperature | Nightly variation from your baseline, and the absolutes behind it |
| health_get_core_temperature | Body temperature readings you logged by hand |
| health_get_cardio_fitness | VO2 max, where the device reports it |
| health_get_food_log | Food calories and water, where logged |
| health_get_ecg | Electrocardiograms: classification, average rate, duration, waveform on request |
| health_get_irregular_rhythm | Irregular-rhythm notifications and the windows that triggered them |
| health_get_devices | Paired devices, battery level, last sync |
| health_get_profile | Your profile, settings and irregular-rhythm enrolment, as Google returns them |
| health_get_lifetime_stats | Totals and best days over the cached history, with its coverage |
| health_trends | Aggregated averages and period comparisons |
Requirements
- Python 3.13+ (tested on 3.13 and 3.14, on Linux, macOS and Windows, in CI)
- A Google account with health data, and a Google Cloud project to authorise against. **No billing account is needed** - the console offers a free trial throughout setup and you can decline all of it.
Setup
1. Install
Or run it without installing, in which case every google-health-mcp ... command you run below becomes uvx google-health-mcp ...:
2. Create the Google Cloud project
Every user registers their own OAuth client. This is seven console steps, and the page names are Google's as of August 2026.
**Google's own setup page will send you somewhere else - follow the steps below instead.** Its quick-start builds a *Web* client with https://www.google.com as the redirect URI, which suits the OAuth Playground rather than a program running on your machine; this server refuses that file and says so. Use that page only to check whether one of the pages below has been renamed.
1. **Project.** Create a project at console.cloud.google.com/projectcreate and select it.
2. **API.** Enable **Google Health API** on the API Enablement page.
3. **Get started.** Open **Google Auth Platform** and complete **Get started** - app name, support email, **External** audience, contact email. A new project has no Audience, Data Access or Clients page until this is done.
4. **Audience.** Under **Test users**, add your own Google account. Skipping this fails sign-in with 403: access_denied.
5. **Data Access.** Click **Add or remove scopes**, search for "Google Health API", and tick the read-only scopes listed under OAuth scopes below.