# google-health-mcp

Connect an AI agent to authorized Google Health API v4 data through local OAuth. Use it to query Fitbit, Pixel Watch, and partner data from your coding chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 72
- Author: davidmosiah
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davidmosiah/google-health-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/google-health-mcp

## What it does

This server lets an agent access a user's Google Health API v4 data, including information from Fitbit, Pixel Watch, and partners. OAuth authorization runs locally, and tokens stay on your machine. The project is unofficial and in beta; it is not a medical device and does not provide medical advice.

Before setup, create an OAuth client in Google Cloud, enable the Google Health API, and add `http://127.0.0.1:3000/callback` as the redirect URI. Then register the server with Claude Code using the command below and your client secret. Without OAuth configuration, the server cannot access authorized health data.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GOOGLE_HEALTH_CLIENT_ID`, `GOOGLE_HEALTH_CLIENT_SECRET`, `GOOGLE_HEALTH_REDIRECT_URI`, `GOOGLE_HEALTH_TOKEN_PATH`, `GOOGLE_HEALTH_PRIVACY_MODE`, `GOOGLE_HEALTH_CACHE`, `GOOGLE_HEALTH_CACHE_PATH`, `GOOGLE_HEALTH_NO_CACHE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env GOOGLE_HEALTH_CLIENT_ID=<GOOGLE_HEALTH_CLIENT_ID> --env GOOGLE_HEALTH_CLIENT_SECRET=<GOOGLE_HEALTH_CLIENT_SECRET> --env GOOGLE_HEALTH_REDIRECT_URI=<GOOGLE_HEALTH_REDIRECT_URI> --env GOOGLE_HEALTH_TOKEN_PATH=<GOOGLE_HEALTH_TOKEN_PATH> --env GOOGLE_HEALTH_PRIVACY_MODE=<GOOGLE_HEALTH_PRIVACY_MODE> --transport stdio google-health-mcp -- npx -y google-health-mcp-unofficial
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add google-health-mcp --env GOOGLE_HEALTH_CLIENT_ID=<GOOGLE_HEALTH_CLIENT_ID> --env GOOGLE_HEALTH_CLIENT_SECRET=<GOOGLE_HEALTH_CLIENT_SECRET> --env GOOGLE_HEALTH_REDIRECT_URI=<GOOGLE_HEALTH_REDIRECT_URI> --env GOOGLE_HEALTH_TOKEN_PATH=<GOOGLE_HEALTH_TOKEN_PATH> --env GOOGLE_HEALTH_PRIVACY_MODE=<GOOGLE_HEALTH_PRIVACY_MODE> -- npx -y google-health-mcp-unofficial
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "google-health-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "google-health-mcp-unofficial"
            ],
            "env": {
                "GOOGLE_HEALTH_CLIENT_ID": "<GOOGLE_HEALTH_CLIENT_ID>",
                "GOOGLE_HEALTH_CLIENT_SECRET": "<GOOGLE_HEALTH_CLIENT_SECRET>",
                "GOOGLE_HEALTH_REDIRECT_URI": "<GOOGLE_HEALTH_REDIRECT_URI>",
                "GOOGLE_HEALTH_TOKEN_PATH": "<GOOGLE_HEALTH_TOKEN_PATH>",
                "GOOGLE_HEALTH_PRIVACY_MODE": "<GOOGLE_HEALTH_PRIVACY_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "google-health-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "google-health-mcp-unofficial"
            ],
            "env": {
                "GOOGLE_HEALTH_CLIENT_ID": "<GOOGLE_HEALTH_CLIENT_ID>",
                "GOOGLE_HEALTH_CLIENT_SECRET": "<GOOGLE_HEALTH_CLIENT_SECRET>",
                "GOOGLE_HEALTH_REDIRECT_URI": "<GOOGLE_HEALTH_REDIRECT_URI>",
                "GOOGLE_HEALTH_TOKEN_PATH": "<GOOGLE_HEALTH_TOKEN_PATH>",
                "GOOGLE_HEALTH_PRIVACY_MODE": "<GOOGLE_HEALTH_PRIVACY_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GOOGLE_HEALTH_CLIENT_ID=<GOOGLE_HEALTH_CLIENT_ID> -e GOOGLE_HEALTH_CLIENT_SECRET=<GOOGLE_HEALTH_CLIENT_SECRET> -e GOOGLE_HEALTH_REDIRECT_URI=<GOOGLE_HEALTH_REDIRECT_URI> -e GOOGLE_HEALTH_TOKEN_PATH=<GOOGLE_HEALTH_TOKEN_PATH> -e GOOGLE_HEALTH_PRIVACY_MODE=<GOOGLE_HEALTH_PRIVACY_MODE> google-health-mcp npx -y google-health-mcp-unofficial
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- query Fitbit data through an AI agent
- inspect sleep and activity data exposed by Google Health API
- bring Pixel Watch data into an agent chat
- authorize local access to personal health data

## Example prompts
- Summarize my Fitbit activity for the available period.
- Show which sleep records I can access through Google Health.
- Compare my activity data from Google Health and Pixel Watch.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md