google-health-mcp

Unofficial. A community project, not made, endorsed or supported by Google or Fitbit.

Ask Claude, ChatGPT or Grok about your Fitbit or Pixel Watch data: "How did I sleep?", "Steps this month?", "Map my last run". A private, read-only MCP server for the Google Health API that runs free on your own Vercel account. It can only read your data, never change it.

Setup

You need a Fitbit or Pixel Watch synced to the Fitbit / Google Health app, plus free Vercel and GitHub accounts. It takes about 10 minutes.

1. Deploy

Click Deploy with Vercel above. Vercel copies this repo to your GitHub, creates a private storage area for your Google sign-in, and asks for one value:

• MCP_HTTP_TOKEN: a random password of 32+ characters (a password manager can generate one, or run openssl rand -hex 32). Your AI apps use it to reach your data. Save it.

2. Connect Google

Open https://YOUR-APP.vercel.app/auth. The first time, it shows a short checklist for creating a Google sign-in, with direct links and your app's exact redirect URI to copy. Then you add two values in Vercel, redeploy, reload the page and sign in with Google.

3. Connect your AI app

Add your server address, https://YOUR-APP.vercel.app/mcp, as a connector and click Connect. A page on your own server opens and asks for your MCP_HTTP_TOKEN; type it there and click Allow access. The token never goes into a chat, a URL or the app's settings.

• Claude (web, desktop, phone): Settings → Connectors → Add custom connector → paste the address → Connect.
• ChatGPT: turn on Developer mode under Settings → Apps & Connectors, create a connector with the address and authentication OAuth.
• Grok: grok.com/connectors → New Connector → Custom → paste the address → finish the sign-in that opens.
• Claude Code: claude mcp add --transport http -s user google-health https://YOUR-APP.vercel.app/mcp, then run /mcp in Claude Code and choose Authenticate.

Apps without sign-in support can still send the token directly: header Authorization: Bearer YOUR_TOKEN, or the URL https://YOUR-APP.vercel.app/mcp?key=YOUR_TOKEN (the parameter is key). Your app's home page shows all of this with your address filled in.

What it can read

Tool	Answers
get_daily_summary	One day at a glance: steps, calories, Active Zone Minutes, resting heart rate, HRV, sleep, workouts
get_daily_rollup	Trends per day or week, up to 90 days
get_rollup	Hour-by-hour values, such as heart rate during a run
get_data_points	Raw records: sleep stages, workouts, weight, SpO2, HRV, ECG
get_exercise_route	A GPS workout's distance, elevation and heart rate. Map points only on request, with 500 m around the start and finish hidden
get_user_info	Profile, units, time zone and goals
list_paired_devices	Devices, battery and last sync
list_data_types	Every readable data type

Food and water logs are not available: the Google Health API has no read permission for them yet.

Skill: better answers (optional)

The google-health-insights skill teaches the AI which tool to use for each question, how to read the raw numbers, how to compare them with your own baseline, and when to suggest seeing a doctor. It's a single file, SKILL.md.

Let your AI install it. Paste this into Claude Code or any coding agent:

Install the google-health-insights skill from https://github.com/gokulkrishh/google-health-mcp.
Download https://raw.githubusercontent.com/gokulkrishh/google-health-mcp/main/skills/google-health-insights/SKILL.md
and save it as ~/.claude/skills/google-health-insights/SKILL.md, creating the folder if needed.
Then confirm the file starts with "name: google-health-insights".

Or install it yourself:

• Claude Code:

  mkdir -p ~/.claude/skills/google-health-insights && curl -fsSL https://raw.githubusercontent.com/gokulkrishh/google-health-mcp/main/skills/google-health-insights/SKILL.md -o ~/.claude/skills/google-health-insights/SKILL.md
  

  Start a new session to load it. It's already active when you work inside this repo.

• Claude apps (web, desktop, phone): download SKILL.md, put it in a folder named google-health-insights, zip that folder, and upload the zip as a custom skill in claude.ai settings.

• Other AI apps: any app that supports Agent Skills can use the same folder. For apps without skills, paste the contents of SKILL.md into the app's custom instructions or project instructions.

To update the skill later, run the same command or prompt again.

Grok Bot template

grok-bot/TEMPLATE.md sets up a Health Coach Grok Bot in a few copy-pastes: the connector, its standing instructions, three skills (/daily-health-brief, /weekly-health-review, /recovery-check), and routines for a morning brief and a Sunday review.

This is the beginning of the README. Read the rest at the original. Read the full README ↗