fitbitmcp — Fitbit MCP server for Claude Code
Connects Fitbit activity, sleep, and health metrics to an MCP agent. Useful when you want to ask questions about your data instead of copying figures from the Fitbit app.
claude mcp add --env FITBIT_CLIENT_ID=<FITBIT_CLIENT_ID> --env FITBIT_CLIENT_SECRET=<FITBIT_CLIENT_SECRET> --env FITBIT_REDIRECT_URI=<FITBIT_REDIRECT_URI> --env FITBIT_TOKEN_PATH=<FITBIT_TOKEN_PATH> --env FITBIT_PRIVACY_MODE=<FITBIT_PRIVACY_MODE> --transport stdio fitbitmcp -- npx -y fitbit-mcp-unofficialWhat fitbitmcp does
The server gives an agent access to Fitbit summaries for steps, sleep stages, heart rate, HRV, SpO2, breathing rate, weight, and logged food or water. Its tools can check the connection, list available data areas, and retrieve daily or weekly summaries. It uses the official Fitbit Web API and handles OAuth on your machine, so tokens stay local.
You need a Fitbit app with the redirect URI http://127.0.0.1:3000/callback, plus a client ID and secret. Claude Code can launch the server with npx. Intraday heart-rate access depends on app and API permissions; continuous device telemetry is not exposed. Fitbit is moving to the Google Health API, so OAuth or reconnection changes may affect the integration.
What it helps with
- check whether a Fitbit account is connected
- get a daily activity and sleep summary
- compare this week's sleep and activity with the prior week
- see which Fitbit data areas the agent can access
Example prompts for the agent
- Check my Fitbit connection and summarize today's data.
- Compare this week's sleep and activity with last week, then identify a bottleneck.
- Review today's intraday heart-rate data at one-minute detail.
How to install fitbitmcp
Platform CLI
claude mcp add --env FITBIT_CLIENT_ID=<FITBIT_CLIENT_ID> --env FITBIT_CLIENT_SECRET=<FITBIT_CLIENT_SECRET> --env FITBIT_REDIRECT_URI=<FITBIT_REDIRECT_URI> --env FITBIT_TOKEN_PATH=<FITBIT_TOKEN_PATH> --env FITBIT_PRIVACY_MODE=<FITBIT_PRIVACY_MODE> --transport stdio fitbitmcp -- npx -y fitbit-mcp-unofficialReplace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
codex mcp add fitbitmcp --env FITBIT_CLIENT_ID=<FITBIT_CLIENT_ID> --env FITBIT_CLIENT_SECRET=<FITBIT_CLIENT_SECRET> --env FITBIT_REDIRECT_URI=<FITBIT_REDIRECT_URI> --env FITBIT_TOKEN_PATH=<FITBIT_TOKEN_PATH> --env FITBIT_PRIVACY_MODE=<FITBIT_PRIVACY_MODE> -- npx -y fitbit-mcp-unofficialReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"mcpServers": {
"fitbitmcp": {
"command": "npx",
"args": [
"-y",
"fitbit-mcp-unofficial"
],
"env": {
"FITBIT_CLIENT_ID": "<FITBIT_CLIENT_ID>",
"FITBIT_CLIENT_SECRET": "<FITBIT_CLIENT_SECRET>",
"FITBIT_REDIRECT_URI": "<FITBIT_REDIRECT_URI>",
"FITBIT_TOKEN_PATH": "<FITBIT_TOKEN_PATH>",
"FITBIT_PRIVACY_MODE": "<FITBIT_PRIVACY_MODE>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"servers": {
"fitbitmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fitbit-mcp-unofficial"
],
"env": {
"FITBIT_CLIENT_ID": "<FITBIT_CLIENT_ID>",
"FITBIT_CLIENT_SECRET": "<FITBIT_CLIENT_SECRET>",
"FITBIT_REDIRECT_URI": "<FITBIT_REDIRECT_URI>",
"FITBIT_TOKEN_PATH": "<FITBIT_TOKEN_PATH>",
"FITBIT_PRIVACY_MODE": "<FITBIT_PRIVACY_MODE>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
gemini mcp add -e FITBIT_CLIENT_ID=<FITBIT_CLIENT_ID> -e FITBIT_CLIENT_SECRET=<FITBIT_CLIENT_SECRET> -e FITBIT_REDIRECT_URI=<FITBIT_REDIRECT_URI> -e FITBIT_TOKEN_PATH=<FITBIT_TOKEN_PATH> -e FITBIT_PRIVACY_MODE=<FITBIT_PRIVACY_MODE> fitbitmcp npx -y fitbit-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 fitbitmcp
How do I install fitbitmcp in Claude Code?
Add the server with claude mcp add fitbitmcp -e FITBIT_CLIENT_SECRET=<FITBIT_CLIENT_SECRET> -- npx -y fitbit-mcp-unofficial. You also need a Fitbit app using the redirect URI http://127.0.0.1:3000/callback.
What does fitbitmcp do?
It gives MCP agents access to Fitbit data such as activity, sleep, heart rate, and HRV. The server also offers tools to check the connection and fetch summaries.
Which Fitbit data can fitbitmcp access?
It supports daily activity, sleep, resting heart rate, HRV, SpO2, breathing rate, weight, and food or water logs when supported by the account or device. Intraday heart-rate access depends on app and API permissions.
