- name
- fitbit
- description
- Query Fitbit health data including sleep, heart rate, activity, SpO2, and breathing rate. Use when user asks about their fitness, sleep quality, steps, or health metrics.
- homepage
- https://www.fitbit.com
- metadata
- clawdbot
- emoji
- 💪
- requires
- bins
- ["fitbit-cli"]
Fitbit CLI
Query health and fitness data from Fitbit wearables.
Commands
Health Data
# Sleep logs (deep, light, REM, awake times)
fitbit-cli -s # today
fitbit-cli -s yesterday # yesterday
fitbit-cli -s last-week # last 7 days
fitbit-cli -s 2026-01-01 # specific date
# Heart rate time series
fitbit-cli -e # today
fitbit-cli -e last-week # last 7 days
# Blood oxygen (SpO2)
fitbit-cli -o # today
fitbit-cli -o last-3-days # last 3 days
# Active Zone Minutes
fitbit-cli -a # today
fitbit-cli -a last-month # last month
# Breathing rate
fitbit-cli -b # today
# Daily activity (steps, calories, distance, floors)
fitbit-cli -t # today
fitbit-cli -t yesterday # yesterdayAccount & Devices
# User profile
fitbit-cli -u
# Connected devices (battery, sync status)
fitbit-cli -dDate Formats
- No parameter: today
- Specific date:
2026-01-05 - Date range:
2026-01-01,2026-01-05 - Relative:
yesterday,last-week,last-month - Custom relative:
last-2-days,last-3-weeks,last-2-months
Usage Examples
User asks "How did I sleep last night?"
fitbit-cli -s yesterdayUser asks "What's my heart rate been like this week?"
fitbit-cli -e last-weekUser asks "How many steps today?"
fitbit-cli -tUser asks "Show my SpO2 levels"
fitbit-cli -oUser asks "Is my Fitbit synced?"
fitbit-cli -dUser asks "How active was I last month?"
fitbit-cli -a last-monthNotes
- Read-only access to Fitbit data
- Tokens auto-refresh (expire after 8 hours)
- Data may be delayed from device sync
- First-time setup:
fitbit-cli --init-auth