whoop-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@whoop-mcp how was my sleep last night?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WHOOP MCP Server
An MCP (Model Context Protocol) server that provides Claude Desktop with access to your WHOOP fitness tracker data, including recovery scores, sleep metrics, and strain data.
Features
Recovery Data: Get your daily recovery score, HRV, resting heart rate, and SpO2
Sleep Analysis: View sleep duration, stages (light/deep/REM), efficiency, and performance
Recovery Trends: Track your recovery over the past 7-14 days
Strain Metrics: Monitor daily strain, calories, and heart rate data
Workout History: View recent workouts with sport type, strain, calories, and HR zones
Related MCP server: Whoop MCP Server
Prerequisites
Python 3.11+
uv package manager
A WHOOP membership and device
WHOOP Developer account (free)
Setup
1. Clone and Install
git clone https://github.com/JasonBates/whoop-mcp-server.git
cd whoop-mcp-server
uv sync2. Create WHOOP Developer App
Go to developer.whoop.com
Sign in with your WHOOP account
Create a new application:
App Name: "WHOOP MCP" (or your preference)
Redirect URI:
http://localhost:8080/callback
Note your Client ID and Client Secret
3. Configure Credentials
Create a .env file from the example:
cp .env.example .envEdit .env and add your credentials:
WHOOP_CLIENT_ID=your_client_id_here
WHOOP_CLIENT_SECRET=your_client_secret_here4. Authorize with WHOOP
Run the token acquisition script:
uv run python scripts/get_tokens.pyThis will:
Open your browser to log in to WHOOP
Request authorization for the app
Save your access and refresh tokens to
.envTest the API connection
5. Configure Claude Desktop
Add the server to your Claude Desktop config at:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"whoop": {
"command": "uv",
"args": [
"--directory",
"/path/to/whoop-mcp-server",
"run",
"python",
"-m",
"whoop_mcp"
]
}
}
}Replace /path/to/whoop-mcp-server with the full path where you cloned the repository.
6. Restart Claude Desktop
Quit and reopen Claude Desktop. You should see "whoop" in the MCP servers list.
Usage
Once configured, you can ask Claude things like:
"What's my WHOOP status today?" (uses the combined summary)
"How did I sleep last night?"
"Show me my recovery trend for the past week"
"What's my current strain?"
"Show me my recent workouts"
Available Tools
Tool | Description |
| Today's recovery, sleep, and strain in one call |
| Sleep history (default 7 days, unlimited) |
| Recovery history (default 7 days, unlimited) |
| Workout history (default 5, unlimited) |
Troubleshooting
"Authentication error: No access token found"
Run the token script: uv run python scripts/get_tokens.py
Tokens expired
The server automatically refreshes tokens, but if you encounter persistent auth errors, re-run the token script.
Multiple machines
Each machine must authorize separately with WHOOP. You cannot copy .env tokens between machines because the first API call on each session refreshes the token, which invalidates it on other machines. Run uv run python scripts/get_tokens.py on each machine you want to use.
Rate limiting
WHOOP API allows 100 requests/minute and 10,000/day. Normal usage is unlikely to hit these limits.
Development
# Test with MCP Inspector
npx @modelcontextprotocol/inspector uv run python -m whoop_mcpLicense
MIT
Available Tools
4 toolsget_recovery_trendA
Get recovery scores for the last N days.
Args: days: Number of days to look back (default: 7, no limit)
Shows the trend of your recovery to help identify patterns.
Inputs: days. Returns: result
get_sleep_trendA
Get sleep data for the last N days.
Args: days: Number of days to look back (default: 7, no limit)
Shows sleep duration, efficiency, and performance trends.
Inputs: days. Returns: result
get_today_summaryA
Get today's complete WHOOP status: recovery, sleep, and strain in one call.
This is the recommended daily check-in tool. Returns:
Recovery score with HRV and resting heart rate
Last night's sleep duration and quality
Current strain level and calories burned
Inputs: no named parameters. Returns: result
get_workoutsA
Get recent workouts with strain and heart rate data.
Args: limit: Number of workouts to return (default: 5, no limit)
Shows your recent activities including sport type, strain, duration, calories, and heart rate zones.
Inputs: limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct aspect of WHOOP data: recovery trend, sleep trend, today's summary, and workouts. There is no overlap between the tools.
All tools follow a consistent verb_noun pattern (get_recovery_trend, get_sleep_trend, get_today_summary, get_workouts), making it easy to predict tool names.
With 4 tools covering recovery, sleep, daily summary, and workouts, the set is well-scoped for a health data summary server. The number is appropriate for the domain.
Core daily metrics are covered, but missing historical strain trend, detailed HRV or heart rate data retrieval, and other WHOOP features like cycle tracking. Some gaps exist.
Maintenance
Related MCP Connectors
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
Your WHOOP data in the assistant, read-only: recovery, sleep, strain, workouts, cycles and body meas
Read WHOOP recovery, sleep, cycles, workouts and body measurements.
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Related MCP Servers
- AlicenseAqualityDmaintenanceGives Claude access to your WHOOP health data including recovery, sleep, workouts, cycles, body measurements, and profile via the WHOOP Developer API.7MIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude to read your Whoop recovery, sleep, cycle, and workout data through natural language queries.-
- AlicenseNot gradedqualityDmaintenanceConnects WHOOP fitness and recovery data to Claude Desktop, enabling users to query workouts, sleep, recovery, and trends through natural language.MIT
- FlicenseAqualityDmaintenanceEnables Claude to read your WHOOP health data including recovery, sleep, strain, and workouts through the official WHOOP API, so you can ask natural language questions about your fitness metrics.7-