whoopskill
WHOOP CLI for fetching health data (sleep, recovery, workouts, HRV, strain).
When & Why to Use This Skill
The whoopskill is a specialized Command Line Interface (CLI) tool designed to bridge the gap between WHOOP's wearable health data and your local development environment or AI agent. It enables users to programmatically fetch comprehensive health metrics—including recovery scores, sleep stages, HRV, strain, and workout details—directly via the WHOOP API v2. By providing structured JSON output and human-readable summaries, it simplifies the process of integrating personal biometric data into custom applications, automated reports, or health-tracking workflows.
Use Cases
- Personalized Daily Briefings: Use Claude to fetch your WHOOP 'summary' and 'recovery' data each morning to generate a custom AI-driven advice on whether to push hard or focus on rest.
- Health Data Export and Archiving: Automate the retrieval of daily sleep and workout metrics to populate personal databases, Notion pages, or spreadsheets for long-term trend analysis.
- Fitness Workflow Integration: Incorporate real-time strain and recovery data into developer dashboards or terminal-based productivity setups to monitor physical readiness alongside work output.
- Custom Health Insights: Query specific historical dates (e.g., using --date) to correlate past workout intensities with recovery patterns, helping to optimize training cycles.
| name | whoopskill |
|---|---|
| description | WHOOP CLI for fetching health data (sleep, recovery, workouts, HRV, strain). |
| homepage | https://github.com/koala73/whoopskill |
| metadata | {"clawdis":{"emoji":"💪","requires":{"bins":["node"],"env":["WHOOP_CLIENT_ID","WHOOP_CLIENT_SECRET","WHOOP_REDIRECT_URI"]},"install":[{"id":"npm","kind":"npm","package":"whoopskill","bins":["whoopskill"],"label":"Install whoopskill (npm)"}]}} |
whoopskill
Use whoopskill to fetch WHOOP health metrics (sleep, recovery, HRV, strain, workouts).
Install: npm install -g whoopskill | GitHub
Quick start
whoopskill summary— one-liner: Recovery: 52% | HRV: 39ms | Sleep: 40% | Strain: 6.7whoopskill --pretty— human-readable output with emojiswhoopskill— fetch all today's data (JSON)whoopskill recovery— recovery score, HRV, RHRwhoopskill sleep— sleep performance, stageswhoopskill workout— workouts with strainwhoopskill --date 2025-01-03— specific date
Data types
profile— user info (name, email)body— height, weight, max HRsleep— sleep stages, efficiency, respiratory raterecovery— recovery %, HRV, RHR, SpO2, skin tempworkout— strain, HR zones, caloriescycle— daily strain, calories
Combine types
whoopskill --sleep --recovery --body
Auth
whoopskill auth login— OAuth flow (opens browser)whoopskill auth status— check token statuswhoopskill auth logout— clear tokens
Notes
- Output is JSON to stdout (use
--prettyfor human-readable) - Tokens stored in
~/.whoop-cli/tokens.json(auto-refresh) - Uses WHOOP API v2
- Date follows WHOOP day boundary (4am cutoff)
- WHOOP apps with <10 users don't need review (immediate use)
Sample output
{
"date": "2026-01-05",
"fetched_at": "2026-01-05T13:49:22.782Z",
"body": {
"height_meter": 1.83,
"weight_kilogram": 82.5,
"max_heart_rate": 182
},
"sleep": [
{
"id": "4c311bd4-370f-49ff-b58c-0578d543e9d2",
"cycle_id": 1236731435,
"user_id": 245199,
"created_at": "2026-01-05T00:23:34.264Z",
"updated_at": "2026-01-05T02:23:54.686Z",
"start": "2026-01-04T19:51:57.280Z",
"end": "2026-01-05T01:30:48.660Z",
"timezone_offset": "+04:00",
"nap": false,
"score_state": "SCORED",
"score": {
"stage_summary": {
"total_in_bed_time_milli": 20331380,
"total_awake_time_milli": 4416000,
"total_light_sleep_time_milli": 6968320,
"total_slow_wave_sleep_time_milli": 4953060,
"total_rem_sleep_time_milli": 3994000,
"sleep_cycle_count": 4,
"disturbance_count": 4
},
"sleep_needed": {
"baseline_milli": 26783239,
"need_from_sleep_debt_milli": 6637715,
"need_from_recent_strain_milli": 148919
},
"respiratory_rate": 14.12,
"sleep_performance_percentage": 40,
"sleep_consistency_percentage": 60,
"sleep_efficiency_percentage": 78.28
}
}
],
"workout": [
{
"id": "4279883e-3d23-45cd-848c-3afa28dca3f8",
"user_id": 245199,
"start": "2026-01-05T03:14:13.417Z",
"end": "2026-01-05T04:06:45.532Z",
"sport_name": "hiit",
"score_state": "SCORED",
"score": {
"strain": 6.19,
"average_heart_rate": 108,
"max_heart_rate": 144,
"kilojoule": 819.38,
"zone_durations": {
"zone_zero_milli": 167000,
"zone_one_milli": 1420000,
"zone_two_milli": 1234980,
"zone_three_milli": 330000,
"zone_four_milli": 0,
"zone_five_milli": 0
}
}
}
],
"profile": {
"user_id": 245199,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
},
"recovery": [
{
"cycle_id": 1236731435,
"sleep_id": "4c311bd4-370f-49ff-b58c-0578d543e9d2",
"user_id": 245199,
"score_state": "SCORED",
"score": {
"recovery_score": 52,
"resting_heart_rate": 60,
"hrv_rmssd_milli": 38.87,
"spo2_percentage": 96.4,
"skin_temp_celsius": 33.19
}
}
],
"cycle": [
{
"id": 1236731435,
"user_id": 245199,
"start": "2026-01-04T19:51:57.280Z",
"end": null,
"score_state": "SCORED",
"score": {
"strain": 6.66,
"kilojoule": 6172.94,
"average_heart_rate": 71,
"max_heart_rate": 144
}
}
]
}