Guide 08 · AI for Recovery
Miss AI · Free
Claude
× WHOOP.
Give your AI access to your recovery, sleep and workouts — so it can actually coach you.
Keira Nesdale · @RealMissAI
Free Guide
5-step setup
~20 minutes
Your data stays local
↓ Download PDF
The Setup
Your recovery,
read in real time.
Imagine asking Claude "how recovered am I today?" or "plan my training week around my sleep" — and it answers with your actual WHOOP data. That is what this setup does.
This guide installs a small bridge program on your computer that connects WHOOP to Claude. Once it is running, Claude can read your recovery scores, sleep stages, strain, and cycle data in real time and factor them into anything you plan together.
✓Your WHOOP login never leaves your machine
✓Claude can only read — never change — your data
✓No third-party cloud involved
Before you start
WHOOP account
Any active WHOOP membership. You will use your normal WHOOP login throughout.
Claude on your computer
The Claude desktop app, Claude Code in your terminal, or Cursor all work.
Node.js installed
Free. If you do not have it, grab it at
nodejs.org before starting.
Time check: this takes about 20 minutes the first time. Most of that is waiting for a few things to install. The actual clicking is minimal.
Step by Step
Connect in
five steps.
1
Get your keys from WHOOP
WHOOP needs to know it is really you asking. You will create a small "app" on their developer site — think of it as making yourself a key to your own data.
2.Create a new app. Name it anything you like.
3.Where it asks for a Redirect URI, paste this exactly — one wrong character and the login will not work:
http://127.0.0.1:3000/callback
4.Tick the boxes for what Claude is allowed to see: profile, recovery, sleep, workouts and cycles.
5.Save. WHOOP gives you two codes: a Client ID and a Client Secret. Copy both somewhere safe right now. The secret only shows once.
2
Install the WHOOP helper
Next you install a small bridge program on your computer — the connector between WHOOP and Claude. The easiest way is to let Claude do it for you. Open Claude and say:
"Install a WHOOP MCP server for me. Here are my keys: [Client ID] and [Client Secret]"
Claude sets it up and stores your two codes safely on your machine, where only you can read them.
3
Introduce the bridge to your AI app
Now tell your AI app the bridge exists. Pick whichever you use:
▸Claude desktop app — go to Settings → Developer → Edit Config and add the WHOOP server there. Claude can write this bit for you too. Then restart the app.
▸Claude Code — ask Claude: "add the WHOOP server to my MCP config" and it runs the command for you. Type /mcp afterwards to confirm it is connected.
▸Cursor — open Cursor Settings → MCP → Add new MCP server. The Claude Code option above works inside Cursor's terminal too.
How to know it worked: once it is connected, Claude gains new abilities with names like whoop_daily_summary. That is your green light.
4
Log in once — and only once
Ask Claude to connect to WHOOP. Your browser opens with WHOOP's normal login page. Log in and click Allow.
That is it. Your computer remembers the connection and quietly keeps it alive. You will never need to log in again.
5
Try it out
Ask Claude something only your WHOOP would know:
Recovery check
"What's my recovery score today?"
Sleep review
"How did I sleep last night?"
Training plan
"Plan my training week around my sleep data."
Strain check
"What was my strain score yesterday?"
If your real numbers come back, you are connected. From now on Claude can factor your recovery, sleep, and strain into everything you plan together.
Troubleshooting
If something's
not working.
| What you see |
What to do |
| Login page bounces immediately |
The Redirect URI from Step 1 was not pasted exactly. Go back to your WHOOP app settings at developer.whoop.com and fix it character for character: http://127.0.0.1:3000/callback |
| Some data comes back empty |
You missed a tick-box in Step 1. Return to developer.whoop.com, tick the missing scope (profile / recovery / sleep / workouts / cycles), save, then redo the login in Step 4 once more. |
| Nothing works at all |
Ask Claude: "check my WHOOP connection status" — it will tell you exactly which piece needs attention. Often it is just Node.js needing an update. Grab the latest at nodejs.org. |
Tip: when in doubt, the fastest fix is always to ask Claude directly. It knows the setup it just ran and can diagnose its own configuration.