How do I get data for a specific date?

Use a date in YYYY-MM-DD format with commands like fitbit activity or fitbit summary, or use today for the current date.

What data can I retrieve with this skill?

You can access activity data (including steps), daily summaries, and health metrics like sleep and weight, with optional JSON output via --json.

Fitbit Health Skill

@pb3975

npx machina-cli add skill @pb3975/fitbit-health --openclaw

Files (1)

SKILL.md

1.7 KB

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

Source

git clone https://clawhub.ai/pb3975/fitbit-healthView on GitHub

Overview

Fitbit CLI lets you pull activity, sleep, heart rate, and weight data from Fitbit's Web API. Use it to answer health questions or verify your metrics with date-specific queries and optional JSON output.

How This Skill Works

After registering a Fitbit app, configure the CLI with fitbit configure and authorize with fitbit login. The CLI stores OAuth tokens in ~/.config/fitbit-cli/tokens.json and refreshes them automatically, enabling commands like fitbit activity, fitbit summary, or fitbit today to fetch data for a specific date (YYYY-MM-DD) or today.

When to Use It

When you need steps or other activity data for a specific date
When you want a full daily summary, including sleep and weight, for a date
When you need heart rate information for today or a given date
When you want to check your weight or weight trend for a date
When you want a quick, authenticated snapshot of today's Fitbit metrics

Quick Start

Step 1: Register a Fitbit app and run fitbit configure to set your Client ID
Step 2: Run fitbit login to authorize; your tokens are stored automatically
Step 3: Query data (e.g., fitbit today or fitbit summary 2026-03-07 --json) and review results

Best Practices

Always authenticate once and use fitbit status to verify before querying
Pass a date with YYYY-MM-DD or use today for reproducible results
Use --json for easy parsing and integration with dashboards
Combine fitbit activity (steps) with fitbit summary for context
Secure tokens: keep them under ~/.config/fitbit-cli with 600 permissions

Example Use Cases

What were my steps on 2026-03-07? -> fitbit activity steps 2026-03-07
Show full summary for yesterday in JSON -> fitbit summary 2026-03-07 --json
Get today's activity and heart rate -> fitbit today
How much did I weigh on 2026-03-08? -> fitbit summary 2026-03-08
Check authentication status -> fitbit status

Frequently Asked Questions

Add this skill to your agents