Whoop MCP Server

by souravpnio.github.souravpn/whoop-mcpv1.0.2

MCP server for WHOOP — gives Claude access to your recovery, sleep, strain, and workout data

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing5mo ago

Install Whoop MCP server

claude mcp add whoop-souravpn -e WHOOP_CLIENT_ID='<whoop-client-id>' -e WHOOP_CLIENT_SECRET='<whoop-client-secret>' -- npx -y @souravpn/whoop-mcp

{
  "mcpServers": {
    "whoop-souravpn": {
      "command": "npx",
      "args": [
        "-y",
        "@souravpn/whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop-client-id>",
        "WHOOP_CLIENT_SECRET": "<whoop-client-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "whoop-souravpn": {
      "command": "npx",
      "args": [
        "-y",
        "@souravpn/whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop-client-id>",
        "WHOOP_CLIENT_SECRET": "<whoop-client-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "whoop-souravpn": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@souravpn/whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop-client-id>",
        "WHOOP_CLIENT_SECRET": "<whoop-client-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "whoop-souravpn": {
      "command": "npx",
      "args": [
        "-y",
        "@souravpn/whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop-client-id>",
        "WHOOP_CLIENT_SECRET": "<whoop-client-secret>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
WHOOP_CLIENT_ID	yes	—	OAuth2 Client ID from your WHOOP developer app at developer-dashboard.whoop.com
WHOOP_CLIENT_SECRET	yes	yes	OAuth2 Client Secret from your WHOOP developer app. Run whoop-mcp-auth-setup once to complete OAuth flow.

Freshness

Slowing — last maintenance signal 5mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-05-27 · 5mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-05-27 · 5mo ago · official registry · v1.0.2

FAQ

›How do I install the Whoop MCP server in Claude Code?

Run: claude mcp add whoop-souravpn -e WHOOP_CLIENT_ID='<whoop-client-id>' -e WHOOP_CLIENT_SECRET='<whoop-client-secret>' -- npx -y @souravpn/whoop-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Whoop require an API key?

Yes. It expects WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET, of which 1 is a secret.

›Can I use Whoop as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Whoop in the official MCP registry?

Yes, as io.github.souravpn/whoop-mcp.