/fitbit-health

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