Skill Details
Back to Skills

/fitbit-health

by pb3975

Query Fitbit health data (activity, sleep, heart rate, weight) via CLI. Use when answering health/fitness questions that require Fitbit data, or when the user asks about their steps, sleep, heart rate

View on GitHub

Fitbit CLI

Retrieve health and fitness data from Fitbit's Web API.

Setup

  1. Register an app at https://dev.fitbit.com/apps
    • OAuth 2.0 Application Type: Personal
    • Callback URL: http://localhost:18787/callback
  2. Run fitbit configure and enter your Client ID
  3. Run fitbit login to authorize

Quick Reference

# Setup & auth
fitbit configure              # Set client ID (first time)
fitbit login                  # Authorize via browser
fitbit logout                 # Sign out
fitbit status                 # Check auth status

# Data
fitbit profile                # User profile info
fitbit activity [date]        # Daily activity summary
fitbit activity steps [date]  # Just steps
fitbit summary [date]         # Full daily summary
fitbit today                  # Today's summary (shortcut)

Options

All commands support:

  • --json — JSON output
  • --no-color — Plain text output
  • --verbose — Debug/HTTP details
  • --tz <zone> — Override timezone (e.g., America/Chicago)

Examples

# Get today's step count
fitbit activity steps

# Get yesterday's full summary as JSON
fitbit summary 2026-01-25 --json

# Check if authenticated
fitbit status

Notes

  • Dates default to today if omitted
  • Date format: YYYY-MM-DD or today
  • Tokens are stored in ~/.config/fitbit-cli/tokens.json (chmod 600)
  • Token refresh is automatic