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:

whoop-cli dashboard — get current state + 7-day context
whoop-cli trends --days 30 --json — get 30-day trend data
whoop-cli --sleep --recovery --workout --cycle -s <30d-ago> -e <today> --all — raw data for all key metrics
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) ↓