# Fitbit

> 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.

- Skill: `kbarbel640-del/fitbit` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/fitbit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/fitbit/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/fitbit

---


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