whoop-as 1.0.0

WHOOP MCP server for Claude — access recovery, sleep, workouts, and cycle data

WHOOP MCP Server for Claude

Access your WHOOP fitness data (recovery, sleep, workouts, cycles) directly in Claude Code, Claude Desktop, and the Claude web app via the Model Context Protocol.

Ask Claude "should I go heavy today?" and have it answer from your actual recovery, HRV, sleep, and strain data.

Features

• 6 powerful tools expose your WHOOP data to Claude:

  • whoop_get_daily_summary — recovery + sleep + today's strain in one call
  • whoop_get_recovery — recovery score, HRV, resting HR, SpO2, skin temp
  • whoop_get_sleep — performance/efficiency scores, sleep stages, disturbances
  • whoop_get_workouts — strain, HR zones, calories, distance by sport
  • whoop_get_cycles — WHOOP day summaries with strain and HR metrics
  • whoop_get_profile / whoop_get_body_measurements — user info and measurements

• Local & private — runs as a stdio MCP server on your machine; your tokens never leave

• Automatic token refresh — handles OAuth refresh token rotation seamlessly

• Works everywhere — Claude Code CLI, Claude Desktop app, and claude.ai/code

Quick Start

1. Install via pip

pip install whoop-mcp

2. Create a WHOOP Developer App

1. Go to the WHOOP Developer Dashboard
2. Sign in with your WHOOP account
3. Create an App and add Redirect URI: http://localhost:8765/callback
4. Enable scopes: offline read:profile read:recovery read:cycles read:sleep read:workout read:body_measurement
5. Copy your Client ID and Client Secret

3. Set up credentials

Create or update .env in your home directory or the repo root:

WHOOP_CLIENT_ID=your_client_id_here
WHOOP_CLIENT_SECRET=your_client_secret_here
WHOOP_REDIRECT_URI=http://localhost:8765/callback

4. Authenticate (one time)

whoop-mcp-auth

Browser opens → sign in to WHOOP → approve. Tokens are saved to ~/.whoop-mcp/tokens.json and refreshed automatically.

5. Add to Claude Code

claude mcp add --transport stdio whoop --scope user -- python -m whoop_mcp.server

Or with a specific Python interpreter:

claude mcp add --transport stdio whoop --scope user -- /path/to/python -m whoop_mcp.server

6. Add to Claude Desktop (Optional)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "whoop": {
      "command": "python",
      "args": ["-m", "whoop_mcp.server"]
    }
  }
}

Then restart Claude Desktop.

Usage

Once installed, you can ask Claude things like:

• "Show me my recovery and sleep for the last week"
• "How's my strain today?"
• "What was my hardest workout this month?"
• "Should I go heavy or recovery today?"

Claude will use the WHOOP tools to fetch real data and answer based on your actual fitness metrics.

Troubleshooting

Problem	Solution
No WHOOP tokens found	Run whoop-mcp-auth to authenticate
redirect_uri mismatch	Ensure .env WHOOP_REDIRECT_URI matches your Dashboard settings exactly
Permission denied (403)	Enable all required scopes in the Developer Dashboard, then re-run whoop-mcp-auth
Auth fails silently	Check that WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET are correct in .env
Tokens keep expiring	The refresh token was revoked — re-run whoop-mcp-auth
MCP server won't connect	Verify the server is running: python -m whoop_mcp.server should start without errors

Development

To develop locally:

git clone https://github.com/anmolsharma/whoop-mcp.git
cd whoop-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
whoop-mcp-auth
python -m whoop_mcp.server

License

MIT — See LICENSE for details.