Introduction
# 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`