Fitbit Health Data Integration for Openclaw

A command-line interface for querying comprehensive health and fitness metrics from Fitbit wearables.

mjrussell
v0.1.0
Jan 9, 2026
2
3.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install fitbit

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install fitbit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Fitbit Health Data Integration?

The Fitbit skill enables AI agents to retrieve personal health data directly from the Fitbit API. By leveraging this tool within the ecosystem of Openclaw Skills, developers can provide users with real-time insights into their physical well-being, including detailed sleep analysis, heart rate trends, and activity tracking. This integration bridges the gap between wearable hardware and intelligent software environments.

Built for efficiency, it allows for granular data retrieval across various timeframes, from a single day to several months. Whether monitoring recovery through SpO2 and breathing rates or tracking daily movement goals, this skill provides a secure, read-only gateway to your Fitbit account data.

Fitbit Health Data Integration Use Cases

  • Summarizing sleep quality and sleep stages from the previous night.
  • Monitoring heart rate trends over the last week to assess cardiovascular health.
  • Tracking daily step counts, calorie burn, and floors climbed.
  • Checking Fitbit device battery status and synchronization logs.
  • Analyzing Active Zone Minutes to ensure weekly fitness targets are met.

How Fitbit Health Data Integration Works

  1. User initiates a request for health or activity data via the agent.
  2. The AI agent translates the request into a specific command for the fitbit-cli tool.
  3. The skill authenticates with the Fitbit API using pre-configured OAuth2 credentials.
  4. Health metrics are fetched for the requested date range or specific metric category.
  5. The structured data is returned to the agent for interpretation and user presentation.

Fitbit Health Data Integration Setup

To begin using this skill within Openclaw Skills, ensure you have the fitbit-cli binary installed on your system. Run the initial authentication command to link your Fitbit account:

fitbit-cli --init-auth

Follow the browser prompts to authorize access. The skill manages token refreshing automatically every 8 hours thereafter.

Fitbit Health Data Integration Data Schema & Taxonomy

Metric Description CLI Flag
Sleep Stages (Deep, Light, REM) and duration -s
Heart Rate Time series heart rate data -e
SpO2 Blood oxygen saturation levels -o
Activity Steps, calories, distance, and floors -t
Active Zones Active Zone Minutes and intensity data -a
Breathing Respiratory rate during sleep -b
Profile User account and biographical data -u
Devices Battery levels and sync timestamps -d

Fitbit Health Data Integration Advanced Features

  • Support for custom relative date ranges such as last-3-weeks or last-2-months.
  • Automatic OAuth2 token management with 8-hour auto-refresh logic for headless operation.
  • Comprehensive cross-metric analysis combining sleep, heart rate, and activity in a single workflow.
  • Seamless integration into multi-agent pipelines through the standard Openclaw Skills interface.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*