Skip to content
MCP server

Whoop MCP

Privacy-first, unofficial WHOOP MCP server for AI health, sleep, recovery, and…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.5.3
Listing updated
6 days ago

About Whoop MCP

Whoop MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Privacy-first, unofficial WHOOP MCP server for AI health, sleep, recovery, and performance agents.

Install

Run in a terminal

claude mcp add whoop-mcp --env WHOOP_CLIENT_SECRET='<WHOOP_CLIENT_SECRET>' -- npx -y whoop-mcp-unofficial

Add to claude_desktop_config.json

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "whoop-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • WHOOP_CLIENT_IDWHOOP OAuth client ID. Optional when configured with whoop-mcp-server setup.
  • WHOOP_CLIENT_SECRETWHOOP OAuth client secret. Prefer whoop-mcp-server setup so this secret is stored in ~/.whoop-mcp/config.json instead of MCP client config.
  • WHOOP_REDIRECT_URIRedirect URI configured in the WHOOP Developer Dashboard. Optional when configured with whoop-mcp-server setup.
  • WHOOP_TOKEN_PATHOptional local path for OAuth tokens. Defaults to ~/.whoop-mcp/tokens.json.
  • WHOOP_PRIVACY_MODEOptional payload mode: summary, structured, or raw. Defaults to structured. raw means full WHOOP API payloads, not raw device sensor streams.
  • WHOOP_CACHEOptional SQLite cache toggle. Set to true or sqlite to enable.
  • WHOOP_CACHE_PATHOptional local SQLite cache path. Defaults to ~/.whoop-mcp/cache.sqlite.
  • WHOOP_NO_CACHESet to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless.

Pricing

Open source

Prices change. Check wellness.delx.ai before you buy.

Whoop MCP FAQ

Is Whoop MCP free?

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

How do I add Whoop MCP to Claude Code?

Run this command in your terminal: claude mcp add whoop-mcp --env WHOOP_CLIENT_SECRET='<WHOOP_CLIENT_SECRET>' -- npx -y whoop-mcp-unofficial

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers