WHOOP

---

name: whoop description: WHOOP morning check-in (recovery/sleep/strain) with suggestions. metadata: clawdbot: config: requiredEnv: - WHOOP_CLIENT_ID - WHOOP_CLIENT_SECRET - WHOOP_REFRESH_TOKEN

---

whoop

WHOOP morning check-in:

fetches your latest WHOOP data (Recovery, Sleep, Cycle/Strain)

generates a short set of suggestions for the day

Quick Start (User + Bot)

What the user does (one-time)

1) Create a WHOOP app and get credentials:

WHOOP_CLIENT_ID

WHOOP_CLIENT_SECRET

2) In the WHOOP developer dashboard, set Redirect URL:

https://localhost:3000/callback

3) Put secrets into ~/.clawdbot/.env:

WHOOP_CLIENT_ID=...
WHOOP_CLIENT_SECRET=...

4) Authorize once (get refresh token):

node /home/claw/clawd/skills/whoop/bin/whoop-auth --redirect-uri https://localhost:3000/callback

Open the printed URL on your phone/browser

Tap Allow/Authorize

Copy the code from the callback URL and paste it back

This writes WHOOP_REFRESH_TOKEN=... into ~/.clawdbot/.env.

What the bot does (each run)

Run:

node /home/claw/clawd/skills/whoop/bin/whoop-morning

Then send the output back to the user.

Automation (daily)

Recommended: schedule with Gateway cron (daily morning).

Command: node /home/claw/clawd/skills/whoop/bin/whoop-morning

Bot should send the output as a message.

Notes

OAuth endpoints:

- auth: https://api.prod.whoop.com/oauth/oauth2/auth - token: https://api.prod.whoop.com/oauth/oauth2/token

Requires offline scope to receive refresh tokens.

WHOOP rotates refresh tokens; the newest refresh token must be saved.

OAuth endpoints:

- auth: https://api.prod.whoop.com/oauth/oauth2/auth - token: https://api.prod.whoop.com/oauth/oauth2/token

Requires offline scope to receive refresh tokens.

WHOOP rotates refresh tokens; the newest refresh token must be saved.