google-health-fitbit-mcp — Claude Code MCP server: setup
This local MCP server lets an AI agent read Google Health data through OAuth. Use it to query Fitbit, Pixel Watch, sleep and activity records.
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-fitbit-mcp -- npx -y google-health-fitbit-mcpWhat google-health-fitbit-mcp does
The server connects an agent to the Google Health API and exposes data from Fitbit, Pixel Watch and supported partner sources. OAuth tokens stay on your machine and are stored with 0600 permissions. Its shipped data tools are read-only; write access is not enabled.
You’ll need a Desktop-type Google Cloud OAuth client with the Google Health API enabled. The project is in beta because the API is still changing, so check authorization and available data before relying on it in production. When Google’s consent screen is in Testing status, refresh tokens are revoked after 7 days and you’ll need to authorize again.
What it helps with
- read Fitbit data through an AI agent
- query sleep and activity records
- check whether Google Health is connected
- access data from Pixel Watch and partner sources
Example prompts for the agent
- Check whether my Google Health account is connected and report the result.
- Summarize the sleep data available from my Google Health account.
- Query activity data from Fitbit and Pixel Watch.
How to install google-health-fitbit-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-fitbit-mcp -- npx -y google-health-fitbit-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
codex mcp add google-health-fitbit-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-fitbit-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"mcpServers": {
"google-health-fitbit-mcp": {
"command": "npx",
"args": [
"-y",
"google-health-fitbit-mcp"
],
"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-fitbit-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-health-fitbit-mcp"
],
"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-fitbit-mcp npx -y google-health-fitbit-mcpReplace <…> 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-fitbit-mcp
How do I install google-health-fitbit-mcp in Claude Code?
Run claude mcp add google-health-fitbit-mcp -e GOOGLE_HEALTH_CLIENT_SECRET=<GOOGLE_HEALTH_CLIENT_SECRET> -- npx -y google-health-fitbit-mcp. You’ll also need a Google Cloud Desktop OAuth client with the Google Health API enabled.
What does google-health-fitbit-mcp do?
It runs locally as an MCP server and lets an agent read Google Health data, including records from Fitbit and Pixel Watch. Its data tools do not write to the account.
What do I need to connect it to Google Health?
Create a Desktop-type OAuth client in Google Cloud and enable the Google Health API. If the consent screen is in Testing status, Google revokes refresh tokens after 7 days, so you’ll need to authorize again.
