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