WHOOP Skill

Use the bundled script to query WHOOP data using the OAuth token file created by the relay.

Prereqs

• •WHOOP OAuth tokens stored at WHOOP_TOKEN_FILE.
• •WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET set for token refresh.

Usage

Run the script directly from the skill folder:

node {baseDir}/scripts/whoop.js <command> [args]

Commands:

• •profile - Get basic user profile.
• •measurements - Get body measurements.
• •sleep latest - Get the most recent sleep record.
• •sleep latest formatted - Get latest sleep with local time computed from WHOOP timezone_offset (use this for summaries).
• •workout latest - Get the most recent workout record.
• •recovery latest - Get the most recent recovery record.
• •cycle latest - Get the most recent cycle record.
• •api <path> [key=value ...] - Call any WHOOP endpoint (path is appended to the base URL).

Examples:

node {baseDir}/scripts/whoop.js sleep latest
node {baseDir}/scripts/whoop.js sleep latest formatted
node {baseDir}/scripts/whoop.js workout latest
node {baseDir}/scripts/whoop.js api /v2/activity/sleep limit=3

Notes:

• •If endpoint paths change, use api with the path shown in WHOOP API docs.
• •The script refreshes tokens when they are expired and a refresh token is available.

Response style for summaries

• •Use short labeled lines or bullets; never return a single long paragraph.
• •Keep tone neutral and professional; avoid casual phrasing.
• •Prefer local time from sleep latest formatted.
• •Include only the key metrics requested; keep each metric on its own line.
• •If offering guidance, keep it to one concise line at the end.