skills/clawdbot/skills/whoop-morning

whoop-morning

SKILL.md

whoop-morning

Morning WHOOP check-in:

  • fetches your latest WHOOP data (Recovery, Sleep, Cycle/Strain)
  • generates a short set of suggestions for the day

Setup

1) Create WHOOP OAuth credentials

You already have:

  • WHOOP_CLIENT_ID
  • WHOOP_CLIENT_SECRET

Store these in ~/.clawdbot/.env.

2) Authorize once (get refresh token)

Run:

/home/claw/clawd/skills/whoop-morning/bin/whoop-auth --scopes offline read:recovery read:sleep read:cycles read:profile

This prints an authorization URL. Open it in your browser, approve, and paste the code back into the terminal.

The script will exchange it for tokens and write WHOOP_REFRESH_TOKEN=... to ~/.clawdbot/.env.

3) Run the morning report

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

Automation

Recommended: schedule with Gateway cron (daily, morning). The cron job should run whoop-morning and send its output as a message.

Notes

  • This skill uses WHOOP OAuth2:
    • auth URL: https://api.prod.whoop.com/oauth/oauth2/auth
    • token URL: https://api.prod.whoop.com/oauth/oauth2/token
  • WHOOP rotates refresh tokens; avoid running multiple refreshes in parallel.
  • API availability/fields can change; if WHOOP returns 401/400 during token refresh, re-run whoop-auth.
Weekly Installs
5
Repository
clawdbot/skills
Installed on
windsurf3
opencode3
codex3
clawdbot2
trae2
cursor2