google-health-mcp — Claude Code MCP server: features and setup
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.
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-unofficialWhat google-health-mcp 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.
What it helps with
- 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 for the agent
- 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.
How to install google-health-mcp
Platform CLI
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-unofficialReplace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
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-unofficialReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"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
Config file
{
"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
Platform CLI
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-unofficialReplace <…> with your own values. 3 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about google-health-mcp
How do I install google-health-mcp in Claude Code?
Create an OAuth client in Google Cloud and configure the Google Health API first. Then run claude mcp add google-health-mcp -e GOOGLE_HEALTH_CLIENT_SECRET=<GOOGLE_HEALTH_CLIENT_SECRET> -- npx -y google-health-mcp-unofficial. OAuth setup is also needed for authorized access.
What does google-health-mcp do?
It connects an AI agent to user-authorized Google Health API v4 data using OAuth. The server runs locally, keeping tokens on your machine.
Which health data sources can google-health-mcp access?
It works with Google Health API v4 data, including Fitbit, Pixel Watch, and partner information. Access depends on user authorization.
