whoopskill

WHOOP CLI for fetching health data (sleep, recovery, workouts, HRV, strain).

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

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.
namewhoopskill
descriptionWHOOP CLI for fetching health data (sleep, recovery, workouts, HRV, strain).
homepagehttps://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.7
  • whoopskill --pretty — human-readable output with emojis
  • whoopskill — fetch all today's data (JSON)
  • whoopskill recovery — recovery score, HRV, RHR
  • whoopskill sleep — sleep performance, stages
  • whoopskill workout — workouts with strain
  • whoopskill --date 2025-01-03 — specific date

Data types

  • profile — user info (name, email)
  • body — height, weight, max HR
  • sleep — sleep stages, efficiency, respiratory rate
  • recovery — recovery %, HRV, RHR, SpO2, skin temp
  • workout — strain, HR zones, calories
  • cycle — daily strain, calories

Combine types

  • whoopskill --sleep --recovery --body

Auth

  • whoopskill auth login — OAuth flow (opens browser)
  • whoopskill auth status — check token status
  • whoopskill auth logout — clear tokens

Notes

  • Output is JSON to stdout (use --pretty for 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
      }
    }
  ]
}