whoop-mcp MCP Server

MCP server that exposes your Whoop fitness data (recovery, sleep, strain, workouts) to Claude for use as a daily training coach.

Local serverstdio

What is the whoop-mcp Server?

whoop-mcp is an MCP project maintained in the cbellbell-spin/whoop-mcp repository. The maintainer describes its purpose as “MCP server that exposes your Whoop fitness data (recovery, sleep, strain, workouts) to Claude for use as a daily training coach”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using python. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
whoop_check_authVerify tokens are valid and not expired
whoop_get_latest_recoveryMost recent recovery score, HRV, resting HR, SpO2
whoop_get_recovery_rangeRecovery data for a date range
whoop_get_latest_sleepLast sleep session with stage breakdown
whoop_get_sleep_rangeSleep data for a date range
whoop_get_latest_strainCurrent cycle strain, avg/max HR, kilojoules
whoop_get_strain_rangeStrain over past N days with average
whoop_get_workoutsWorkouts with sport ID, strain, HR zones
whoop_get_profileUser profile and body measurements
whoop_get_training_summaryAggregated coaching snapshot (start here)

How to install the whoop-mcp Server

{
  "mcpServers": {
    "whoop": {
      "command": "python",
      "args": [
        "/absolute/path/to/whoop-mcp/src/whoop_server.py"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "your-client-id",
        "WHOOP_CLIENT_SECRET": "YOUR_WHOOP_CLIENT_SECRET"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
WHOOP_CLIENT_IDDeclared in the maintainer’s client configuration.Check documentation
WHOOP_CLIENT_SECRETDeclared in the maintainer’s client configuration.Check documentation