io.github.davidmosiah/whoop-mcp MCP Server

Name: io.github.davidmosiah/whoop-mcp MCP Server
Author: io.github.davidmosiah

io.github.davidmosiah/whoop-mcp

Repository Registry

What is the io.github.davidmosiah/whoop-mcp MCP server?

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

How to install io.github.davidmosiah/whoop-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<YOUR_WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<YOUR_WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<YOUR_WHOOP_REDIRECT_URI>",
        "WHOOP_TOKEN_PATH": "<YOUR_WHOOP_TOKEN_PATH>",
        "WHOOP_PRIVACY_MODE": "<YOUR_WHOOP_PRIVACY_MODE>",
        "WHOOP_CACHE": "<YOUR_WHOOP_CACHE>",
        "WHOOP_CACHE_PATH": "<YOUR_WHOOP_CACHE_PATH>",
        "WHOOP_NO_CACHE": "<YOUR_WHOOP_NO_CACHE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<YOUR_WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<YOUR_WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<YOUR_WHOOP_REDIRECT_URI>",
        "WHOOP_TOKEN_PATH": "<YOUR_WHOOP_TOKEN_PATH>",
        "WHOOP_PRIVACY_MODE": "<YOUR_WHOOP_PRIVACY_MODE>",
        "WHOOP_CACHE": "<YOUR_WHOOP_CACHE>",
        "WHOOP_CACHE_PATH": "<YOUR_WHOOP_CACHE_PATH>",
        "WHOOP_NO_CACHE": "<YOUR_WHOOP_NO_CACHE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<YOUR_WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<YOUR_WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<YOUR_WHOOP_REDIRECT_URI>",
        "WHOOP_TOKEN_PATH": "<YOUR_WHOOP_TOKEN_PATH>",
        "WHOOP_PRIVACY_MODE": "<YOUR_WHOOP_PRIVACY_MODE>",
        "WHOOP_CACHE": "<YOUR_WHOOP_CACHE>",
        "WHOOP_CACHE_PATH": "<YOUR_WHOOP_CACHE_PATH>",
        "WHOOP_NO_CACHE": "<YOUR_WHOOP_NO_CACHE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "whoop-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "whoop-mcp-unofficial"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<YOUR_WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<YOUR_WHOOP_CLIENT_SECRET>",
        "WHOOP_REDIRECT_URI": "<YOUR_WHOOP_REDIRECT_URI>",
        "WHOOP_TOKEN_PATH": "<YOUR_WHOOP_TOKEN_PATH>",
        "WHOOP_PRIVACY_MODE": "<YOUR_WHOOP_PRIVACY_MODE>",
        "WHOOP_CACHE": "<YOUR_WHOOP_CACHE>",
        "WHOOP_CACHE_PATH": "<YOUR_WHOOP_CACHE_PATH>",
        "WHOOP_NO_CACHE": "<YOUR_WHOOP_NO_CACHE>"
      }
    }
  }
}

Claude Code

claude mcp add whoop-mcp --env WHOOP_CLIENT_ID=<YOUR_WHOOP_CLIENT_ID> --env WHOOP_CLIENT_SECRET=<YOUR_WHOOP_CLIENT_SECRET> --env WHOOP_REDIRECT_URI=<YOUR_WHOOP_REDIRECT_URI> --env WHOOP_TOKEN_PATH=<YOUR_WHOOP_TOKEN_PATH> --env WHOOP_PRIVACY_MODE=<YOUR_WHOOP_PRIVACY_MODE> --env WHOOP_CACHE=<YOUR_WHOOP_CACHE> --env WHOOP_CACHE_PATH=<YOUR_WHOOP_CACHE_PATH> --env WHOOP_NO_CACHE=<YOUR_WHOOP_NO_CACHE> -- npx -y whoop-mcp-unofficial