HomeOther › whoop-mcp

whoop-mcp

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

TypeScript CloudLocal macOSWindowsLinux
★ 13 stars Last pushed 2026-08-29 License: MIT

Topics: Sports

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.5.3)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<YOUR_VALUE>",
        "WHOOP_CLIENT_SECRET": "<YOUR_VALUE>",
        "WHOOP_REDIRECT_URI": "<YOUR_VALUE>",
        "WHOOP_TOKEN_PATH": "<YOUR_VALUE>",
        "WHOOP_PRIVACY_MODE": "<YOUR_VALUE>",
        "WHOOP_CACHE": "<YOUR_VALUE>",
        "WHOOP_CACHE_PATH": "<YOUR_VALUE>",
        "WHOOP_NO_CACHE": "<YOUR_VALUE>"
      }
    }
  }
}
  • WHOOP_CLIENT_ID — WHOOP OAuth client ID. Optional when configured with whoop-mcp-server setup.
  • WHOOP_CLIENT_SECRET secret — WHOOP 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_URI — Redirect URI configured in the WHOOP Developer Dashboard. Optional when configured with whoop-mcp-server setup.
  • WHOOP_TOKEN_PATH — Optional local path for OAuth tokens. Defaults to ~/.whoop-mcp/tokens.json.
  • WHOOP_PRIVACY_MODE — Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full WHOOP API payloads, not raw device sensor streams.
  • WHOOP_CACHE — Optional SQLite cache toggle. Set to true or sqlite to enable.
  • WHOOP_CACHE_PATH — Optional local SQLite cache path. Defaults to ~/.whoop-mcp/cache.sqlite.
  • WHOOP_NO_CACHE — Set 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.

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry