Fitbit Health Skill

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, or weight from Fitbit.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install fitbit-health

Fitbit CLI

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

Setup

Register an app at https://dev.fitbit.com/apps
- OAuth 2.0 Application Type: Personal
- Callback URL: http://localhost:18787/callback
Run fitbit configure and enter your Client ID
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