Agent skill · data analytics · sundial-org
whoop-2
Access Whoop wearable health data (sleep, recovery, strain, HRV, workouts) and generate interactive charts. Use when the user asks about sleep quality, recovery scores, strain levels, HRV trends, workout data, or wants health visualizations/graphs from their Whoop band.
Why this skill is useful
Adds executable scripts for fetching and visualizing health data from the Whoop API, which the AI cannot generate on its own.
What it needs
Requires python3 installed locally. Requires whoop account access. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Whoop Query health metrics from the Whoop API and generate interactive HTML charts. Setup (first time only) 1. Create a Whoop Developer App 1. Go to developer-dashboard.whoop.com 2. Sign in with your Whoop account credentials 3. Create a Team if prompted (any name works) 4. Click Create App (or go to apps/create) 5. Fill in: App name: anything (e.g., "Clawdbot") Scopes: select ALL: read:recovery, read:cycles, read:workout, read:sleep, read:profile, read:bodymeasurement Redirect URI: http://localhost:9876/callback 6. Click Create — you'll get a Client ID and Client Secret 2. Authenticate Run the OAuth login flow with your credentials: This opens a browser for Whoop authorization. Log in and approve access. Tokens are stored in ~/.clawdbot/whoop-tokens.json and auto-refresh. Check status: python3 scripts/whoopauth.py status Fetching Data Use scripts/whoopdata.py to get JSON data: Output is JSON to stdout. Parse it to answer user questions. Generating Charts Use scripts/whoopchart.py for interactive HTML visualizations: Charts open automatically in the default browser. They use Chart.js with dark theme, stat cards, and tooltips. Answering Questions User asks Action ----------- -------- "How did I sleep?" whoopdata.py summary --days 7, report sleep performance + hours "How's my recovery?" whoopdata.py recovery --days 7, report scores + trend "Show me a chart for the last month" whoopchart.py dashboard --days 30 "Is my HRV improving?" whoopdata.py recovery --days 30, analyze trend "How much did I train this week?" whoopdata.py workouts --days 7, list activities Key Metrics Recovery (0-100%): Green ≥67%, Yellow 34-66%, Red <34% Strain (0-21): Daily exertion score based on HR Sleep Performance: Actual sleep vs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/whoop-2