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 # yesterday
Account & Devices
# User profile
fitbit-cli -u
# Connected devices (battery, sync status)
fitbit-cli -d
Date 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 yesterday
User asks "What's my heart rate been like this week?"
fitbit-cli -e last-week
User asks "How many steps today?"
fitbit-cli -t
User asks "Show my SpO2 levels"
fitbit-cli -o
User asks "Is my Fitbit synced?"
fitbit-cli -d
User asks "How active was I last month?"
fitbit-cli -a last-month
Notes
- 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