โ† All skills
Tencent SkillHub ยท Developer Tools

WHOOP Tracker

Access WHOOP fitness tracker data via API, including recovery scores, sleep metrics, workout stats, daily strain, and body measurements. Use when the user asks about their WHOOP data, fitness metrics, recovery status, sleep quality, workout performance, or wants to track health trends.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Access WHOOP fitness tracker data via API, including recovery scores, sleep metrics, workout stats, daily strain, and body measurements. Use when the user asks about their WHOOP data, fitness metrics, recovery status, sleep quality, workout performance, or wants to track health trends.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
AUDIT.md, SKILL.md, references/api-reference.md, references/oauth.md, scripts/get_profile.py, scripts/get_recovery.py

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.1

Documentation

ClawHub primary doc Primary doc: SKILL.md 26 sections Open source page

WHOOP API

Retrieve and analyze fitness data from WHOOP wearables via the official REST API.

Usage Snippet

# Install (if using Clawdhub) clawdhub install whoop-tracker # From the skill root: python3 scripts/get_recovery.py --today python3 scripts/get_sleep.py --last python3 scripts/get_workouts.py --days 7 python3 scripts/get_profile.py

Prerequisites

Python 3.7+ requests library: pip3 install requests (or run bash scripts/install.sh)

1. Register Application

Go to https://developer.whoop.com Create a new app and note your client_id and client_secret Set redirect URI (e.g., http://localhost:8080/callback)

2. Save Credentials

mkdir -p ~/.whoop cat > ~/.whoop/credentials.json <<EOF { "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET" } EOF chmod 600 ~/.whoop/credentials.json

3. Authorize (see references/oauth.md for full guide)

Open the authorization URL in browser User grants permissions โ†’ redirected with code Exchange code for tokens via WhoopClient.authenticate(code, redirect_uri)

4. Fetch Data

All scripts are run from the skill root directory: # Today's recovery python3 scripts/get_recovery.py --today # Last night's sleep python3 scripts/get_sleep.py --last # Recent workouts python3 scripts/get_workouts.py --days 7 # User profile python3 scripts/get_profile.py

Recovery

Recovery Score (0-100): Readiness for strain HRV (RMSSD): Heart rate variability in milliseconds Resting Heart Rate: Morning baseline HR SPO2: Blood oxygen percentage Skin Temperature: Deviation from baseline in ยฐC

Sleep

Performance %: How well you slept vs. your sleep need Duration: Total time in bed and per stage (REM, SWS, light, awake) Efficiency %: Time asleep / time in bed Consistency %: How consistent your sleep schedule is Respiratory Rate: Breaths per minute Sleep Needed/Debt: Baseline need and accumulated debt

Cycle (Daily Strain)

Strain Score: Cardiovascular load (0-21 scale) Kilojoules: Energy expenditure Average/Max Heart Rate: Daily HR metrics

Workout

Strain: Activity-specific strain score Sport: Activity type (running, cycling, etc.) Heart Rate Zones: Time spent in each of 6 zones Distance/Altitude: GPS metrics (if available)

API Endpoints

Base URL: https://api.prod.whoop.com See references/api-reference.md for full endpoint documentation with response schemas. User Profile: GET /v1/user/profile/basic โ€” Name, email GET /v1/user/body_measurement โ€” Height, weight, max HR Recovery: GET /v1/recovery โ€” All recovery data (paginated) GET /v1/cycle/{cycleId}/recovery โ€” Recovery for specific cycle Sleep: GET /v1/sleep โ€” All sleep records (paginated) GET /v1/sleep/{sleepId} โ€” Specific sleep by ID GET /v1/cycle/{cycleId}/sleep โ€” Sleep for specific cycle Cycle: GET /v1/cycle โ€” All physiological cycles (paginated) GET /v1/cycle/{cycleId} โ€” Specific cycle by ID Workout: GET /v1/workout โ€” All workouts (paginated) GET /v1/workout/{workoutId} โ€” Specific workout by ID All collection endpoints support start, end (ISO 8601), limit (max 25), and nextToken (pagination cursor).

Required OAuth Scopes

read:profile โ€” User name and email read:body_measurement โ€” Height, weight, max HR read:recovery โ€” Recovery scores and HRV read:sleep โ€” Sleep metrics and stages read:cycles โ€” Daily strain data read:workout โ€” Activity and workout data

scripts/whoop_client.py

Core API client. Features: OAuth token storage and auto-refresh Token expiry tracking (proactive refresh) Rate limit handling (429 with retry) Automatic pagination iterators (iter_recovery, iter_sleep, iter_cycles, iter_workouts)

scripts/get_recovery.py

python3 scripts/get_recovery.py --today # Today's recovery python3 scripts/get_recovery.py --days 7 # Past week python3 scripts/get_recovery.py --start 2026-01-20 # From date python3 scripts/get_recovery.py --json # Raw JSON output

scripts/get_sleep.py

python3 scripts/get_sleep.py --last # Last night python3 scripts/get_sleep.py --days 7 # Past week python3 scripts/get_sleep.py --json # Raw JSON output

scripts/get_workouts.py

python3 scripts/get_workouts.py --days 7 # Past week python3 scripts/get_workouts.py --sport running # Filter by sport python3 scripts/get_workouts.py --json # Raw JSON output

scripts/get_profile.py

python3 scripts/get_profile.py # Profile + body measurements python3 scripts/get_profile.py --json # Raw JSON output

scripts/install.sh

bash scripts/install.sh # Install pip dependencies + setup guide

"ModuleNotFoundError: No module named 'requests'"

Install dependencies: pip3 install requests or bash scripts/install.sh

"Credentials not found at ~/.whoop/credentials.json"

Create the file with your OAuth client_id and client_secret (see Quick Start step 2).

"Not authenticated"

Complete the OAuth authorization flow (see references/oauth.md).

"401 Unauthorized" after token refresh fails

Your refresh token has expired. Re-authorize from the authorization URL.

"429 Too Many Requests"

Rate limit hit. The client automatically retries after the Retry-After period.

Empty results

Check your date range โ€” use --days 7 or wider range. Ensure your OAuth scopes include the data type you're requesting.

References

references/oauth.md โ€” OAuth setup, token management, authorization flow references/api-reference.md โ€” Complete API endpoint documentation with response schemas

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
4 Docs2 Scripts
  • SKILL.md Primary doc
  • AUDIT.md Docs
  • references/api-reference.md Docs
  • references/oauth.md Docs
  • scripts/get_profile.py Scripts
  • scripts/get_recovery.py Scripts