fitbit – OpenClaw Skill

---

name: fitbit description: 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. metadata: {"clawdbot":{"emoji":"💪","requires":{"bins":["fitbit"]}}}

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

💪 Fitbit Skill for Clawdbot

A Clawdbot skill that provides CLI access to Fitbit health data. Enables your AI agent to answer questions about your activity, heart rate, and fitness metrics.

What is Clawdbot?

Clawdbot is an AI agent platform that connects Claude to your tools, services, and data. Skills extend Clawdbot's capabilities — this one adds Fitbit integration.

Features

• 🔐 Secure OAuth 2.0 PKCE authentication
• 📊 Activity summaries (steps, calories, distance, floors)
• 💓 Heart rate and resting HR data
• 🏃 Active minutes breakdown
• 📅 Historical data by date
• 🤖 Natural language queries through Clawdbot

Installation

As a Clawdbot Skill

# Clone to your Clawdbot workspace skills folder
cd ~/clawd/skills
git clone https://github.com/pb3975/clawdbot-fitbit-skill.git fitbit

# Install and build
cd fitbit
npm install
npm run build

# Link globally so Clawdbot can find the CLI
npm link

Clawdbot will automatically detect the skill via SKILL.md.

Standalone CLI

npm install -g clawdbot-fitbit-skill

Setup

1. Create a Fitbit App

   • Go to dev.fitbit.com/apps
   • Register a new app with:
     • OAuth 2.0 Application Type: Personal
     • Callback URL: http://localhost:18787/callback

2. Configure

   fitbit configure
   

   Enter your Client ID when prompted.

3. Authenticate

   fitbit login
   

   Your browser will open for Fitbit authorization.

Usage

Through Clawdbot (Natural Language)

Once installed, just ask Clawdbot:

• "How many steps did I take today?"
• "What's my resting heart rate?"
• "Show me my activity summary for yesterday"
• "How active was I this week?"

Direct CLI

# Today's summary
fitbit today

# Activity details
fitbit activity
fitbit activity 2024-01-15

# Specific metrics
fitbit activity steps
fitbit activity calories

# User profile
fitbit profile

# Auth status
fitbit status

# Sign out
fitbit logout

Options

All commands support:

• --json — Output as JSON (useful for scripting)
• --no-color — Plain text output
• --verbose — Debug info
• --tz <zone> — Override timezone

Security

• Tokens stored in ~/.config/fitbit-cli/tokens.json with 0600 permissions
• OAuth uses PKCE (no client secret stored)
• Callback server binds to 127.0.0.1 only
• Temp auth files use secure random paths

Related

• Clawdbot - AI agent platform
• ClawdHub - Skill marketplace

License

MIT