drio
Open app

Whoop MCP Server

Source

Catalog onlyCatalog onlySTDIO

Overview

Whoop MCP Server is a Python package that acts as a Model Context Protocol (MCP) server, providing access to the Whoop API for querying cycles, recovery, strain, and workout data.

To use the Whoop MCP Server, you need Whoop credentials for authentication. You can run the server locally or use the HTTP API server to access its functionalities.

  • Access to Whoop API for cycle, recovery, and strain data. - Tools for querying specific data ranges and averages. - User profile and authentication management. - Human-readable error messages for common issues.
  1. Querying recovery scores and strain data for personal fitness tracking.
  2. Analyzing workout data over specific periods.
  3. Integrating with other applications for enhanced fitness insights.

Add to your AI client

Use these steps to connect Whoop MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "whoop-mcp-server-ctvidic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-whoop-mcp-server-ctvidic"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "whoop-mcp-server-ctvidic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-whoop-mcp-server-ctvidic"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "whoop-mcp-server-ctvidic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-whoop-mcp-server-ctvidic"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "whoop-mcp-server-ctvidic": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-whoop-mcp-server-ctvidic"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "whoop-mcp-server-ctvidic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-whoop-mcp-server-ctvidic"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "whoop-mcp-server-ctvidic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-whoop-mcp-server-ctvidic"
      ]
    }
  }
}

FAQ

Do I need a Whoop account to use this server?

Yes, you need valid Whoop credentials for authentication.

Can I run the server on my local machine?

Yes, you can run it locally or use the provided HTTP API server.

What programming language is this server written in?

The Whoop MCP Server is written in Python.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1731,"uuid":"73514a75-de53-4ac5-95b9-eeac83fcb198","name":"whoop-mcp-server","title":"Whoop MCP Server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/80602202?v=4","created_at":"2025-03-05T05:05:06.131Z","updated_at":"2025-03-12T10:20:30.812Z","status":"created","author_name":"ctvidic","author_avatar_url":"https://avatars.githubusercontent.com/u/80602202?v=4","tags":"[]","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/ctvidic/whoop-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"2\",\"license\":\"\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-03-15 11:48:22\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Research and data