- name
- fitbit
- description
- Query Fitbit health data (activity, sleep, heart rate, weight) via CLI. Use when answering health/fitness questions that require Fitbit data, or when the user asks about their steps, sleep, heart rate, or weight from Fitbit.
- metadata
- {"clawdbot":{"emoji":"💪","requires":{"bins":["fitbit"]}}}
Fitbit CLI
Retrieve health and fitness data from Fitbit's Web API.
Setup
- Register an app at https://dev.fitbit.com/apps
- OAuth 2.0 Application Type: Personal - Callback URL: http://localhost:18787/callback
- Run
fitbit configureand enter your Client ID - Run
fitbit loginto authorize
Quick Reference
# Setup & auth
fitbit configure # Set client ID (first time)
fitbit login # Authorize via browser
fitbit logout # Sign out
fitbit status # Check auth status
# Data
fitbit profile # User profile info
fitbit activity [date] # Daily activity summary
fitbit activity steps [date] # Just steps
fitbit summary [date] # Full daily summary
fitbit today # Today's summary (shortcut)Options
All commands support:
--json— JSON output--no-color— Plain text output--verbose— Debug/HTTP details--tz <zone>— Override timezone (e.g.,America/Chicago)
Examples
# Get today's step count
fitbit activity steps
# Get yesterday's full summary as JSON
fitbit summary 2026-01-25 --json
# Check if authenticated
fitbit statusNotes
- Dates default to today if omitted
- Date format:
YYYY-MM-DDortoday - Tokens are stored in
~/.config/fitbit-cli/tokens.json(chmod 600) - Token refresh is automatic