whoop

name

whoop

description

WHOOP CLI for health data, trends, insights, and dashboards. Use when user asks about WHOOP data, health metrics, recovery, HRV, sleep, strain, workouts, or wants to fetch/analyze WHOOP API data. Also use when user says "whoop", "recovery score", "sleep score", "daily strain", "heart rate variability", "resting heart rate", "health dashboard", "health trends", or wants a daily health summary. Trigger on requests like "show my recovery", "how did I sleep", "fetch my WHOOP data", "health insights", "trend analysis".

whoop-cli

Fetch WHOOP health metrics via CLI: sleep, recovery, HRV, strain, workouts.

Install: npm install -g whoop-cli | GitHub

Quick start

whoop-cli auth login        # one-time OAuth via browser
whoop-cli summary --color   # color-coded daily snapshot
whoop-cli dashboard         # full dashboard with 7-day trends
whoop-cli trends --days 14  # 14-day trend analysis

Commands

Command	Description	Default output
sleep	Sleep stages, efficiency, respiratory rate	JSON
recovery	Recovery score, HRV, RHR, SpO2, skin temp	JSON
workout	Workouts with strain, HR zones, calories	JSON
cycle	Daily strain, calories	JSON
profile	User info (name, email)	JSON
body	Height, weight, max HR	JSON
summary	One-liner health snapshot	Pretty
dashboard	Full dashboard with 7-day trends	Pretty
trends	Multi-day averages with trend arrows ↑↓→	Pretty
insights	Health recommendations	Pretty

Flags

Flag	Applies to	Description
-d, --date <date>	data + analysis	Date (YYYY-MM-DD)
-s, --start <date>	data	Range start
-e, --end <date>	data	Range end
-l, --limit <n>	data	Max results per page (default: 25)
-a, --all	data	Fetch all pages
-p, --pretty	data	Human-readable output
-n, --days <number>	trends	7, 14, or 30 only
--json	dashboard, trends, insights	Raw JSON output
-c, --color	summary	Color-coded status indicators
--sleep/--recovery/--workout/--cycle/--profile/--body	global	Select data types

Auth

whoop-cli auth login    # OAuth flow (opens browser)
whoop-cli auth status   # check token (does not refresh)
whoop-cli auth refresh  # refresh access token
whoop-cli auth logout   # clear tokens

Key behaviors

• No args → fetches all data types for today (JSON)
• Data commands → JSON by default; add --pretty for formatted
• Analysis commands → pretty by default; add --json for raw
• WHOOP day boundary is 4:00 AM, not midnight
• Tokens: ~/.whoop-cli/tokens.json, auto-refresh 15 min before expiry
• trends --days only accepts 7, 14, or 30

God mode: composite commands for deep insights

Run multiple commands to collect maximum data, then feed to LLM for analysis.

Best single command for LLM analysis:

whoop-cli dashboard --json            # today (all 5 types) + 7-day history (recovery, sleep, cycle) as raw JSON

This is the most data-dense command: today's profile + recovery + sleep + cycle + workout, plus 7-day arrays of recovery, sleep, and cycle history — all in one JSON blob, no formatting.

Full daily snapshot (formatted for human reading):

whoop-cli --pretty                    # all 6 data types, formatted
whoop-cli dashboard                   # today + 7-day history + trends
whoop-cli insights                    # health recommendations

30-day deep dive (maximum historical context):

whoop-cli trends --days 30 --json     # 30-day trends as JSON
whoop-cli sleep -s 2025-12-31 -e 2026-01-30 --all  # month of sleep data
whoop-cli recovery -s 2025-12-31 -e 2026-01-30 --all  # month of recovery
whoop-cli workout -s 2025-12-31 -e 2026-01-30 --all   # month of workouts
whoop-cli cycle -s 2025-12-31 -e 2026-01-30 --all     # month of strain/cal

Recovery vs strain correlation:

whoop-cli --recovery --workout --cycle -s 2025-12-31 -e 2026-01-30 --all

Sleep quality deep analysis:

whoop-cli --sleep --recovery -s 2025-12-31 -e 2026-01-30 --all

Recommended god mode workflow:

1. whoop-cli dashboard — get current state + 7-day context
2. whoop-cli trends --days 30 --json — get 30-day trend data
3. whoop-cli --sleep --recovery --workout --cycle -s <30d-ago> -e <today> --all — raw data for all key metrics
4. Feed all JSON outputs to LLM for cross-metric analysis: HRV↔sleep, recovery↔strain, sleep duration↔workout performance

Example output

whoop-cli summary --color:

📅 2026-01-25
🟢 Recovery: 85% | HRV: 39ms | RHR: 63bpm
🟡 Sleep: 79% | 6.9h | Efficiency: 97%
🔴 Strain: 0.1 (optimal: ~14) | 579 cal

whoop-cli trends:

📊 7-Day Trends
💚 Recovery: 62.1% avg (34-86) →
💓 HRV: 33.8ms avg (26-42) →
😴 Sleep: 75.4% avg (69-79) →
🔥 Strain: 5.9 avg (0.1-9.0) ↓