🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Fitbit

by @mjrussell

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.

Versionv0.1.0
Downloads2,770
Installs7
Stars⭐ 2
TERMINAL
clawhub install fitbit

πŸ“– About This Skill


name: fitbit description: 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. homepage: https://www.fitbit.com metadata: clawdbot: emoji: "πŸ’ͺ" requires: bins: ["fitbit-cli"]

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
  • πŸ“‹ Tips & Best Practices

  • 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