Skip to main content
Glama

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 sync

2. Create WHOOP Developer App

  1. Go to developer.whoop.com

  2. Sign in with your WHOOP account

  3. Create a new application:

    • App Name: "WHOOP MCP" (or your preference)

    • Redirect URI: http://localhost:8080/callback

  4. Note your Client ID and Client Secret

3. Configure Credentials

Create a .env file from the example:

cp .env.example .env

Edit .env and add your credentials:

WHOOP_CLIENT_ID=your_client_id_here
WHOOP_CLIENT_SECRET=your_client_secret_here

4. Authorize with WHOOP

Run the token acquisition script:

uv run python scripts/get_tokens.py

This will:

  • Open your browser to log in to WHOOP

  • Request authorization for the app

  • Save your access and refresh tokens to .env

  • Test 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

get_today_summary

Today's recovery, sleep, and strain in one call

get_sleep_trend

Sleep history (default 7 days, unlimited)

get_recovery_trend

Recovery history (default 7 days, unlimited)

get_workouts

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_mcp

License

MIT

Available Tools

4 tools
get_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

    A4.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Gives Claude access to your WHOOP health data including recovery, sleep, workouts, cycles, body measurements, and profile via the WHOOP Developer API.
      7
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables 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
      -