Whoop MCP server (remote, for Claude custom connectors)

Read-only access to your Whoop recovery, sleep, strain, workouts and profile from Claude. Single-user. Runs on Render's free tier.

1. Put this code on GitHub

Create a new repo (public or private) and upload these three files: server.js, package.json, README.md.

Related MCP server: whoop-fitness

2. Create a Whoop developer app

1. Go to https://developer.whoop.com → sign in → Create App.

2. Name: anything. Redirect URI: https://YOUR-APP.onrender.com/callback (you'll know YOUR-APP after step 3 — you can come back and edit this).

3. Scopes: tick all read:* scopes and offline.

4. Copy the Client ID and Client Secret.

3. Deploy on Render

1. https://render.com → New → Web Service → connect the GitHub repo.

2. Runtime: Node. Build command: npm install. Start command: npm start. Plan: Free.

3. Environment variables:

4. Deploy. Note your Render URL and make sure the Whoop redirect URI (step 2) matches it exactly.

4. Authorize once

1. Open https://YOUR-APP.onrender.com/auth in a browser and approve Whoop.

2. The page shows a refresh token. Copy it into the WHOOP_REFRESH_TOKEN env var on Render and redeploy. (Render's free tier has no persistent disk, so the token must live in env.)

5. Add to Claude

Claude → Settings → Connectors → Add custom connector

• Name: Whoop

• URL: https://YOUR-APP.onrender.com/mcp/YOUR_MCP_SECRET

• No OAuth fields needed.

Toggle it on in a chat and ask for your recovery.

Notes

• Free Render services sleep after 15 min idle; the first call may take ~30 s to wake.

• Keep MCP_SECRET private — anyone with the URL can read your data.

• Tools: get_today, get_summary, get_recovery, get_sleep, get_cycles, get_workouts, get_profile, get_body_measurements.