🎁 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
Downloads3,603
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