Skip to content
MCP server

Whoop MCP Server

Your WHOOP recovery, sleep, strain and workouts in Claude, ChatGPT or other MCP apps…

Install
Pricing
Open source
Runs
Remotely
Version
1.5.1
Listing updated
5 days ago

About Whoop MCP Server

Whoop MCP Server is an open-source MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Your WHOOP recovery, sleep, strain and workouts in Claude, ChatGPT or other MCP apps. Self-hosted.

Install

Run in a terminal

claude mcp add whoop-mcp-server --env WHOOP_CLIENT_ID='<WHOOP_CLIENT_ID>' --env WHOOP_CLIENT_SECRET='<WHOOP_CLIENT_SECRET>' --env WHOOP_REDIRECT_URI='<WHOOP_REDIRECT_URI>' --env MCP_AUTH_PASSWORD='<MCP_AUTH_PASSWORD>' --env PUBLIC_URL='<PUBLIC_URL>' --env ENCRYPTION_SECRET='<ENCRYPTION_SECRET>' -- docker run -i --rm -e WHOOP_CLIENT_ID -e WHOOP_CLIENT_SECRET -e WHOOP_REDIRECT_URI -e MCP_AUTH_PASSWORD -e PUBLIC_URL -e ENCRYPTION_SECRET ghcr.io/yuridivonis/whoop-mcp-server:1.5.1

Add to claude_desktop_config.json

{
  "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",
        "-e",
        "ENCRYPTION_SECRET",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<WHOOP_REDIRECT_URI>",
        "MCP_AUTH_PASSWORD": "<MCP_AUTH_PASSWORD>",
        "PUBLIC_URL": "<PUBLIC_URL>",
        "ENCRYPTION_SECRET": "<ENCRYPTION_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "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",
        "-e",
        "ENCRYPTION_SECRET",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<WHOOP_REDIRECT_URI>",
        "MCP_AUTH_PASSWORD": "<MCP_AUTH_PASSWORD>",
        "PUBLIC_URL": "<PUBLIC_URL>",
        "ENCRYPTION_SECRET": "<ENCRYPTION_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "whoop-mcp-server": {
      "type": "stdio",
      "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",
        "-e",
        "ENCRYPTION_SECRET",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<WHOOP_REDIRECT_URI>",
        "MCP_AUTH_PASSWORD": "<MCP_AUTH_PASSWORD>",
        "PUBLIC_URL": "<PUBLIC_URL>",
        "ENCRYPTION_SECRET": "<ENCRYPTION_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "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",
        "-e",
        "ENCRYPTION_SECRET",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<WHOOP_REDIRECT_URI>",
        "MCP_AUTH_PASSWORD": "<MCP_AUTH_PASSWORD>",
        "PUBLIC_URL": "<PUBLIC_URL>",
        "ENCRYPTION_SECRET": "<ENCRYPTION_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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",
        "-e",
        "ENCRYPTION_SECRET",
        "ghcr.io/yuridivonis/whoop-mcp-server:1.5.1"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<WHOOP_REDIRECT_URI>",
        "MCP_AUTH_PASSWORD": "<MCP_AUTH_PASSWORD>",
        "PUBLIC_URL": "<PUBLIC_URL>",
        "ENCRYPTION_SECRET": "<ENCRYPTION_SECRET>"
      }
    }
  }
}

Configuration

  • WHOOP_CLIENT_IDClient ID of your WHOOP developer app.Required
  • WHOOP_CLIENT_SECRETClient secret of your WHOOP developer app.Required
  • WHOOP_REDIRECT_URIThe server's /callback address, also added to your WHOOP app. WHOOP needs an https address, such as a tunnel to this computer.Required
  • MCP_AUTH_PASSWORDPassword for the sign-in page that protects /mcp, at least 16 characters.Required
  • PUBLIC_URLThe address MCP clients use to reach the server. Keep the default when running it on this computer.Required
  • ENCRYPTION_SECRETKey for encrypting the stored WHOOP tokens. Defaults to WHOOP_CLIENT_SECRET.
  • UPDATE_CHECKOnce 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.

Pricing

Open source

Whoop MCP Server FAQ

Is Whoop MCP Server free?

Yes. Whoop MCP Server is open source, so you can use and self-host it for free.

How do I add Whoop MCP Server to Claude Code?

Run this command in your terminal: claude mcp add whoop-mcp-server --env WHOOP_CLIENT_ID='<WHOOP_CLIENT_ID>' --env WHOOP_CLIENT_SECRET='<WHOOP_CLIENT_SECRET>' --env WHOOP_REDIRECT_URI='<WHOOP_REDIRECT_URI>' --env MCP_AUTH_PASSWORD='<MCP_AUTH_PASSWORD>' --env PUBLIC_URL='<PUBLIC_URL>' --env ENCRYPTION_SECRET='<ENCRYPTION_SECRET>' -- docker run -i --rm -e WHOOP_CLIENT_ID -e WHOOP_CLIENT_SECRET -e WHOOP_REDIRECT_URI -e MCP_AUTH_PASSWORD -e PUBLIC_URL -e ENCRYPTION_SECRET ghcr.io/yuridivonis/whoop-mcp-server:1.5.1