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.

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill enables seamless integration with Fitbit wearables, allowing users to query comprehensive health and fitness metrics directly through natural language. It provides real-time access to sleep patterns, heart rate variability, activity levels, and oxygen saturation (SpO2), transforming raw wearable data into actionable health insights within the chat interface.

Use Cases

  • Personal Health Monitoring: Quickly check sleep quality scores, including deep, light, and REM cycles from the previous night to optimize recovery.
  • Fitness Progress Tracking: Retrieve daily step counts, active zone minutes, and calorie expenditure to stay on top of personalized fitness goals.
  • Health Trend Analysis: Compare heart rate and breathing rate data over specific periods (e.g., last week or month) to identify physiological trends and wellness patterns.
  • Device Management: Monitor Fitbit device status, including battery levels and synchronization history, to ensure continuous and accurate data tracking.
namefitbit
descriptionQuery 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.
homepagehttps://www.fitbit.com
emoji"💪"
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