davidmosiah avatar

Fitbitmcp

davidmosiah/fitbit-mcp

Connects Claude to your Fitbit data through the official Web API with local OAuth. Exposes daily and weekly summaries, sleep stages, heart rate zones, HRV, SpO2, activity logs, and nutrition. Includes intraday heart rate when your Fitbit app tier supports it. Tokens stay in ~/.fitbit-mcp/tokens.json and never leave your machine. Ships with three prompts for daily check-ins, weekly reviews, and minute-level investigations. Useful if you want Claude to reason over your wearable data without opening the Fitbit app or pasting screenshots. OAuth setup takes about 60 seconds with the interactive CLI. Note that Fitbit is migrating to Google Health API in 2026, so expect some breakage.

GitHub stars
1
tools
27
auth
Secret needed
transport
STDIO
env vars
8
last updated
May 29, 2026

Tools

27 tools

Public tool metadata for what this MCP can expose to an agent.

fitbit_connection_statusverify local setup before calling Fitbit

verify local setup before calling Fitbit

No parameter schema in public metadata yet.

fitbit_data_inventoryinventory supported data domains, scopes, privacy modes and recommended first calls without calling Fitbit APIs.

inventory supported data domains, scopes, privacy modes and recommended first calls without calling Fitbit APIs.

No parameter schema in public metadata yet.

fitbit_daily_summaryreadiness, activity, sleep and heart context for today

readiness, activity, sleep and heart context for today

No parameter schema in public metadata yet.

fitbit_weekly_summaryscorecard, comparison vs prior week, next-week plan

scorecard, comparison vs prior week, next-week plan

No parameter schema in public metadata yet.

fitbit_capabilities

No parameter schema in public metadata yet.

fitbit_agent_manifest

No parameter schema in public metadata yet.

fitbit_privacy_audit

No parameter schema in public metadata yet.

fitbit_cache_status

No parameter schema in public metadata yet.

fitbit_get_auth_url

No parameter schema in public metadata yet.

fitbit_exchange_code

No parameter schema in public metadata yet.

fitbit_revoke_access

No parameter schema in public metadata yet.

fitbit_get_profile

No parameter schema in public metadata yet.

fitbit_list_devices

No parameter schema in public metadata yet.

fitbit_get_activity_day

No parameter schema in public metadata yet.

fitbit_list_activities

No parameter schema in public metadata yet.

fitbit_get_activity

No parameter schema in public metadata yet.

fitbit_get_sleep_day

No parameter schema in public metadata yet.

fitbit_list_sleep

No parameter schema in public metadata yet.

fitbit_get_heart_day

No parameter schema in public metadata yet.

fitbit_heart_series

No parameter schema in public metadata yet.

fitbit_get_heart_intraday

No parameter schema in public metadata yet.

fitbit_get_hrv_day

No parameter schema in public metadata yet.

fitbit_get_spo2_day

No parameter schema in public metadata yet.

fitbit_get_breathing_rate_day

No parameter schema in public metadata yet.

fitbit_get_weight_day

No parameter schema in public metadata yet.

fitbit_get_food_day

No parameter schema in public metadata yet.

fitbit_get_water_day

No parameter schema in public metadata yet.

Sponsors

Configuration

FITBIT_CLIENT_ID

Fitbit OAuth client ID. Optional when configured with fitbit-mcp-server setup.

FITBIT_CLIENT_SECRETsecret

Fitbit OAuth client secret. Prefer fitbit-mcp-server setup so this secret is stored in ~/.fitbit-mcp/config.json instead of MCP client config.

FITBIT_REDIRECT_URI

Redirect URI configured in the Fitbit Developer Dashboard. Optional when configured with fitbit-mcp-server setup.

FITBIT_TOKEN_PATH

Optional local path for OAuth tokens. Defaults to ~/.fitbit-mcp/tokens.json.

FITBIT_PRIVACY_MODE

Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full Fitbit API payloads, not continuous 24/7 raw sensor telemetry.

FITBIT_CACHE

Optional SQLite cache toggle. Set to true or sqlite to enable.

FITBIT_CACHE_PATH

Optional local SQLite cache path. Defaults to ~/.fitbit-mcp/cache.sqlite.

FITBIT_NO_CACHE

Set to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless.

Readme

Fitbit MCP

Fitbit MCP — Fitbit MCP for AI agents

Give your AI agent your Fitbit activity, sleep, heart and HRV data — locally.
Local-first MCP server — tokens never leave your machine.

npm version npm downloads License MIT Site


View the full README on GitHub

Details

Repository
github.com/davidmosiah/fitbit-mcp
Website
wellness.delx.ai/connectors/fitbit
Package
fitbit-mcp-unofficial
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from davidmosiah