← Index

io.github.AshwanthramKL/whoop-mcp

io.github.AshwanthramKL/whoop-mcp·v0.8.5·Databases
Quality Score
80
/100

Read-only WHOOP v2 data for MCP clients, with local SQLite cache and CSV/JSONL/Parquet exports.

§01  Install
Claude Desktop (uvx)
{
  "mcpServers": {
    "whoop-mcp": {
      "command": "uvx",
      "args": [
        "whoop-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop_client_id>",
        "WHOOP_CLIENT_SECRET": "<your-whoop_client_secret>",
        "WHOOP_REDIRECT_URI": "http://localhost:8000/callback",
        "WHOOP_LOG_LEVEL": "INFO",
        "WHOOP_LOG_FILE": "<whoop_log_file>",
        "WHOOP_LOG_JSON": "true"
      }
    }
  }
}
§02  Environment variables
WHOOP_CLIENT_ID
required

Client ID from your WHOOP developer app (https://developer-dashboard.whoop.com/apps/create).

WHOOP_CLIENT_SECRET
requiredsecret

Client secret from your WHOOP developer app. Used for OAuth token refresh.

WHOOP_REDIRECT_URI

OAuth redirect URI. Defaults to http://localhost:8000/callback — only change if you registered a different URI.

WHOOP_LOG_LEVEL

Log level (DEBUG / INFO / WARNING / ERROR). Default INFO.

WHOOP_LOG_FILE

Path to the rotating log file. Set to empty string to disable file logging. Default ~/.whoop-mcp-server/logs/whoop-mcp.log.

WHOOP_LOG_JSON

Structured JSON logs (true) vs human-readable (false). Default true.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
5
§04  Alternatives in Databases