WHOOP MCP Server

by cunicopia-devio.github.cunicopia-dev/whoop-postgres-mcpv0.1.0

Sync WHOOP recovery, sleep, strain, and workouts into Postgres and query them from any MCP client.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active26d ago

Install WHOOP MCP server

claude mcp add whoop-postgres -e WHOOP_CLIENT_ID='<whoop-client-id>' -e WHOOP_CLIENT_SECRET='<whoop-client-secret>' -e WHOOP_REDIRECT_URI='<whoop-redirect-uri>' -e WHOOP_DB_URL='<whoop-db-url>' -- uvx whoop-postgres-mcp

{
  "mcpServers": {
    "whoop-postgres": {
      "command": "uvx",
      "args": [
        "whoop-postgres-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop-client-id>",
        "WHOOP_CLIENT_SECRET": "<whoop-client-secret>",
        "WHOOP_REDIRECT_URI": "<whoop-redirect-uri>",
        "WHOOP_DB_URL": "<whoop-db-url>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "whoop-postgres": {
      "command": "uvx",
      "args": [
        "whoop-postgres-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop-client-id>",
        "WHOOP_CLIENT_SECRET": "<whoop-client-secret>",
        "WHOOP_REDIRECT_URI": "<whoop-redirect-uri>",
        "WHOOP_DB_URL": "<whoop-db-url>"
      }
    }
  }
}

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

{
  "servers": {
    "whoop-postgres": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "whoop-postgres-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop-client-id>",
        "WHOOP_CLIENT_SECRET": "<whoop-client-secret>",
        "WHOOP_REDIRECT_URI": "<whoop-redirect-uri>",
        "WHOOP_DB_URL": "<whoop-db-url>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "whoop-postgres": {
      "command": "uvx",
      "args": [
        "whoop-postgres-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<whoop-client-id>",
        "WHOOP_CLIENT_SECRET": "<whoop-client-secret>",
        "WHOOP_REDIRECT_URI": "<whoop-redirect-uri>",
        "WHOOP_DB_URL": "<whoop-db-url>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
WHOOP_CLIENT_ID	yes	yes	Client ID of your WHOOP developer app (developer.whoop.com).
WHOOP_CLIENT_SECRET	yes	yes	Client secret of your WHOOP developer app.
WHOOP_REDIRECT_URI	yes	—	OAuth redirect URI, exactly as registered on the WHOOP app (e.g. http://localhost:8765/callback).
WHOOP_DB_URL	yes	yes	Postgres DSN the server syncs into and reads from (e.g. postgresql://user:pass@localhost:5432/whoop). Tokens are stored in this database.

Freshness

Active — last maintenance signal 26d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-13 · 26d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-13 · 26d ago · official registry · v0.1.0

FAQ

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

Run: claude mcp add whoop-postgres -e WHOOP_CLIENT_ID='<whoop-client-id>' -e WHOOP_CLIENT_SECRET='<whoop-client-secret>' -e WHOOP_REDIRECT_URI='<whoop-redirect-uri>' -e WHOOP_DB_URL='<whoop-db-url>' -- uvx whoop-postgres-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, WHOOP_REDIRECT_URI, WHOOP_DB_URL, of which 3 are secrets.

›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.cunicopia-dev/whoop-postgres-mcp.