whoopskill

Fetch WHOOP health data across recovery, sleep, HRV, and strain via CLI.

47|14|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/koala73/whoopskill --skill whoopskill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whoopskill
Source: https://github.com/koala73/whoopskill/tree/main
Command: npx skills add https://github.com/koala73/whoopskill --skill whoopskill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fetching and interpreting WHOOP health data can be tedious and error-prone; this Skill provides a CLI to fetch, align, and present recovery, sleep, HRV, and strain metrics from WHOOP API v2, enabling quick decision-making and automation.

Core Features & Use Cases

  • Retrieve live or historical WHOOP data for recovery, sleep, HRV, and strain from a single command.
  • Generate concise summaries or detailed insights and trends for dashboards or daily planning.
  • Use in automation (cron/servers) to refresh tokens and fetch latest metrics for monitoring.

Quick Start

Install and run whoopskill to fetch a snapshot of your health data with a simple command.

Frequently Asked Questions about whoopskill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch WHOOP recovery and sleep data for a specific date range?

To fetch WHOOP recovery and sleep data for a specific date range, run the CLI command specifying your desired dates. It retrieves recovery, sleep, HRV, and strain metrics from WHOOP API v2 and outputs a consolidated payload in pretty or JSON format.

How do I authenticate WHOOP API requests using OAuth?

Authenticating WHOOP API requests requires setting WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET, and WHOOP_REDIRECT_URI as environment variables. The CLI manages tokens locally and handles common API errors with clear messaging.

Can I retrieve multiple WHOOP health metrics in a single query?

Yes, you can retrieve multiple WHOOP health metrics in a single query. The CLI supports multi-type aggregations across sleep, recovery, workout, cycle, profile, and body metrics, with optional pagination for large result sets.

Does the WHOOP CLI work for automated server environments?

The WHOOP CLI works for automated server environments by supporting cron scheduling. It automatically refreshes OAuth tokens and fetches the latest recovery, sleep, and strain metrics for continuous monitoring without manual intervention.

What is the best way to consolidate WHOOP HRV and strain data for dashboards?

The best way to consolidate WHOOP HRV and strain data for dashboards is using a CLI that aligns and presents metrics from WHOOP API v2. It generates concise summaries or detailed insights and trends, enabling quick decision-making for daily planning.