Fitbit CLI
Query health and fitness data from Fitbit wearables.
Commands
Health Data
bash
# 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
bash
# 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?"
bash
fitbit-cli -s yesterday
User asks "What's my heart rate been like this week?"
bash
fitbit-cli -e last-week
User asks "How many steps today?"
bash
fitbit-cli -t
User asks "Show my SpO2 levels"
bash
fitbit-cli -o
User asks "Is my Fitbit synced?"
bash
fitbit-cli -d
User asks "How active was I last month?"
bash
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