Whoop MCP Server

Name: Whoop MCP Server
Author: ctvidic

@ctvidic

Repository

About Whoop MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Whoop": {
      "command": "python",
      "args": [
        "/path/to/whoop/src/whoop_server.py"
      ],
      "cwd": "/path/to/whoop",
      "env": {
        "WHOOP_EMAIL": "[email protected]",
        "WHOOP_PASSWORD": "your_password"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Whoop MCP Server?

A Model Context Protocol (MCP) server that provides language models with access to the Whoop API. It enables querying cycles, recovery, strain, and workout data from Whoop using standard Python. Designed for developers and users who want to integrate Whoop health metrics into AI assistants.

How to use Whoop MCP Server?

Configure the server in Claude for Desktop by adding the "Whoop" entry to claude_desktop_config.json with the command python and the path to whoop_server.py, along with environment variables WHOOP_EMAIL and WHOOP_PASSWORD. Alternatively, run the HTTP API server using the provided run_whoop_server.sh script. Dates must be provided in ISO format (YYYY-MM-DD).

Key features of Whoop MCP Server

get_cycle_collection and get_latest_cycle for cycle queries
get_recovery_data and get_strain_data for specific date ranges
get_average_strain to calculate strain over a given number of days
get_profile and check_auth_status for user info and authentication
Human-readable error messages for common issues (invalid dates, auth errors, network problems)
Supports both MCP (stdio) and HTTP transport

Use cases of Whoop MCP Server

Ask an AI assistant for today's recovery score
Retrieve strain data for the past week
Get the average strain over the last 7 days
Obtain the latest cycle data for analysis

FAQ from Whoop MCP Server

How do I authenticate with the Whoop API?

The server uses email/password authentication. Set the WHOOP_EMAIL and WHOOP_PASSWORD environment variables in the Claude for Desktop configuration or in the .env file.

What date format should I use for tools?

Dates must be provided in ISO 8601 format: YYYY-MM-DD.

What Python version is required?

The server is written for Python 3.12. Dependencies are listed in requirements.txt.

Can I run the server without Claude for Desktop?

Yes. The project includes an HTTP API server (whoop_http_server.py) that exposes the same functionality over HTTP endpoints. Run it with ./run_whoop_server.sh.

Where are the server files located?

The project structure has a whoop/ directory with source files under src/ (whoop_server.py and whoop_http_server.py), a config/ directory for .env, and a requirements.txt.