Whoop MCP Server

Name: Whoop MCP Server
Author: yuridivonis

Community

MCP server by yuridivonis · updated 4 days ago · ★ 15

Score 64

Your WHOOP recovery, sleep, strain and workouts in Claude, ChatGPT or other MCP apps. Self-hosted. Whoop MCP Server is a community project by yuridivonis, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub Website

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit 4 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, original repository

Security

Not checked yet. What we check

What you need

Setting	Needed	What it is
`WHOOP_CLIENT_ID`Environment variable	Required	Client ID of your WHOOP developer app.
`WHOOP_CLIENT_SECRET`Environment variable, secret	Required	Client secret of your WHOOP developer app.
`WHOOP_REDIRECT_URI`Environment variable	Required	The server's /callback address, also added to your WHOOP app. WHOOP needs an https address, such as a tunnel to this computer.
`MCP_AUTH_PASSWORD`Environment variable, secret	Required	Password for the sign-in page that protects /mcp, at least 16 characters.
`PUBLIC_URL`Environment variable	Required	The address MCP clients use to reach the server. Keep the default when running it on this computer. Default: `http://localhost:3000`
`ENCRYPTION_SECRET`Environment variable, secret	Optional	Key for encrypting the stored WHOOP tokens. Defaults to WHOOP_CLIENT_SECRET.
`UPDATE_CHECK`Environment variable	Optional	Once a day, ask GitHub for the latest release number and mention a newer version in get_today. Sends nothing about you. Set to false to turn it off. Default: `true`

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install Whoop MCP Server

Built from the published package, never by AI

claude mcp add whoop-mcp-server -e WHOOP_CLIENT_ID=YOUR_WHOOP_CLIENT_ID -e WHOOP_CLIENT_SECRET=YOUR_WHOOP_CLIENT_SECRET -e WHOOP_REDIRECT_URI=https://your-tunnel.example.com/callback -e MCP_AUTH_PASSWORD=YOUR_MCP_AUTH_PASSWORD -e PUBLIC_URL=YOUR_PUBLIC_URL -- docker run -i --rm -e WHOOP_CLIENT_ID -e WHOOP_CLIENT_SECRET -e WHOOP_REDIRECT_URI -e MCP_AUTH_PASSWORD -e PUBLIC_URL ghcr.io/yuridivonis/whoop-mcp-server:1.5.1

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install Whoop MCP Server in Claude Code

{
  "mcpServers": {
    "whoop-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WHOOP_CLIENT_ID",
        "-e",
        "WHOOP_CLIENT_SECRET",
        "-e",
        "WHOOP_REDIRECT_URI",
        "-e",
        "MCP_AUTH_PASSWORD",
        "-e",
        "PUBLIC_URL",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "YOUR_WHOOP_CLIENT_ID",
        "WHOOP_CLIENT_SECRET": "YOUR_WHOOP_CLIENT_SECRET",
        "WHOOP_REDIRECT_URI": "https://your-tunnel.example.com/callback",
        "MCP_AUTH_PASSWORD": "YOUR_MCP_AUTH_PASSWORD",
        "PUBLIC_URL": "YOUR_PUBLIC_URL"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install Whoop MCP Server in Claude Desktop

{
  "mcpServers": {
    "whoop-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WHOOP_CLIENT_ID",
        "-e",
        "WHOOP_CLIENT_SECRET",
        "-e",
        "WHOOP_REDIRECT_URI",
        "-e",
        "MCP_AUTH_PASSWORD",
        "-e",
        "PUBLIC_URL",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "YOUR_WHOOP_CLIENT_ID",
        "WHOOP_CLIENT_SECRET": "YOUR_WHOOP_CLIENT_SECRET",
        "WHOOP_REDIRECT_URI": "https://your-tunnel.example.com/callback",
        "MCP_AUTH_PASSWORD": "YOUR_MCP_AUTH_PASSWORD",
        "PUBLIC_URL": "YOUR_PUBLIC_URL"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install Whoop MCP Server in Cursor

{
  "servers": {
    "whoop-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WHOOP_CLIENT_ID",
        "-e",
        "WHOOP_CLIENT_SECRET",
        "-e",
        "WHOOP_REDIRECT_URI",
        "-e",
        "MCP_AUTH_PASSWORD",
        "-e",
        "PUBLIC_URL",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "YOUR_WHOOP_CLIENT_ID",
        "WHOOP_CLIENT_SECRET": "YOUR_WHOOP_CLIENT_SECRET",
        "WHOOP_REDIRECT_URI": "https://your-tunnel.example.com/callback",
        "MCP_AUTH_PASSWORD": "YOUR_MCP_AUTH_PASSWORD",
        "PUBLIC_URL": "YOUR_PUBLIC_URL"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install Whoop MCP Server in VS Code

codex mcp add whoop-mcp-server --env WHOOP_CLIENT_ID=YOUR_WHOOP_CLIENT_ID --env WHOOP_CLIENT_SECRET=YOUR_WHOOP_CLIENT_SECRET --env WHOOP_REDIRECT_URI=https://your-tunnel.example.com/callback --env MCP_AUTH_PASSWORD=YOUR_MCP_AUTH_PASSWORD --env PUBLIC_URL=YOUR_PUBLIC_URL -- docker run -i --rm -e WHOOP_CLIENT_ID -e WHOOP_CLIENT_SECRET -e WHOOP_REDIRECT_URI -e MCP_AUTH_PASSWORD -e PUBLIC_URL ghcr.io/yuridivonis/whoop-mcp-server:1.5.1

Step-by-step: install Whoop MCP Server in Codex

{
  "mcpServers": {
    "whoop-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WHOOP_CLIENT_ID",
        "-e",
        "WHOOP_CLIENT_SECRET",
        "-e",
        "WHOOP_REDIRECT_URI",
        "-e",
        "MCP_AUTH_PASSWORD",
        "-e",
        "PUBLIC_URL",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "YOUR_WHOOP_CLIENT_ID",
        "WHOOP_CLIENT_SECRET": "YOUR_WHOOP_CLIENT_SECRET",
        "WHOOP_REDIRECT_URI": "https://your-tunnel.example.com/callback",
        "MCP_AUTH_PASSWORD": "YOUR_MCP_AUTH_PASSWORD",
        "PUBLIC_URL": "YOUR_PUBLIC_URL"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install Whoop MCP Server in Antigravity CLI

gemini mcp add whoop-mcp-server docker run -i --rm -e WHOOP_CLIENT_ID -e WHOOP_CLIENT_SECRET -e WHOOP_REDIRECT_URI -e MCP_AUTH_PASSWORD -e PUBLIC_URL ghcr.io/yuridivonis/whoop-mcp-server:1.5.1

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install Whoop MCP Server in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the whoop-mcp-server block.

Weekly newsletter

Like Whoop MCP Server? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to Whoop MCP Server

All alternatives →

Harness autonomous-ai

Start Claude Code and Codex agents the person can watch, wait for them and read their answers.

AAA Local 1.3k

MCP Registry Server modelcontextprotocol

Publish and discover MCP servers via the official MCP Registry. Powered by HAPI MCP server.

AFA Remote 7.4k

ref-tools-ref-tools-mcp ref-tools

Provide your AI coding tools with token-efficient access to up-to-date technical documentation for…

AAA Remote 1.2k

Microsoft Learn MCP MicrosoftDocs

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

ACA Remote 1.9k

Postman MCP Server postmanlabs

Give your AI agents trusted access to the full Postman platform.

AAB Local and remote 8.5k/wk

Agent-Native DesignBuilderIO

Agent-Native design tool - create and edit visual designs with agent assistance

AAA Remote 7.4k

Whoop MCP Server vs Harness Whoop MCP Server vs MCP Registry Server Whoop MCP Server vs ref-tools-ref-tools-mcp

Whoop MCP Server: common questions

How do I install Whoop MCP Server?

In Claude Code run claude mcp add whoop-mcp-server -e WHOOP_CLIENT_ID=YOUR_WHOOP_CLIENT_ID -e WHOOP_CLIENT_SECRET=YOUR_WHOOP_CLIENT_SECRET -e WHOOP_REDIRECT_URI=https://your-tunnel.example.com/callback -e MCP_AUTH_PASSWORD=YOUR_MCP_AUTH_PASSWORD -e PUBLIC_URL=YOUR_PUBLIC_URL -- docker run -i --rm -e WHOOP_CLIENT_ID -e WHOOP_CLIENT_SECRET -e WHOOP_REDIRECT_URI -e MCP_AUTH_PASSWORD -e PUBLIC_URL ghcr.io/yuridivonis/whoop-mcp-server:1.5.1. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is Whoop MCP Server the official server?

Whoop MCP Server is a community project by yuridivonis, not verified by a company domain.

Is Whoop MCP Server free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is Whoop MCP Server safe to use?

It scores 64 of 100. Grades: maintenance A, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to Whoop MCP Server?

Does Whoop MCP Server work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.