Skip to content
MCP server

WHOOP MCP

Sync WHOOP recovery, sleep, strain, and workouts into Postgres and query them from any…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
4 days ago

About WHOOP MCP

WHOOP MCP is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add whoop-postgres-mcp --env WHOOP_CLIENT_ID='<WHOOP_CLIENT_ID>' --env WHOOP_CLIENT_SECRET='<WHOOP_CLIENT_SECRET>' --env WHOOP_REDIRECT_URI='<WHOOP_REDIRECT_URI>' --env WHOOP_DB_URL='<WHOOP_DB_URL>' -- uvx whoop-postgres-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "whoop-postgres-mcp": {
      "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

{
  "mcpServers": {
    "whoop-postgres-mcp": {
      "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

{
  "servers": {
    "whoop-postgres-mcp": {
      "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 ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "whoop-postgres-mcp": {
      "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 your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "whoop-postgres-mcp": {
      "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>"
      }
    }
  }
}

Configuration

  • WHOOP_CLIENT_IDClient ID of your WHOOP developer app (developer.whoop.com).Required
  • WHOOP_CLIENT_SECRETClient secret of your WHOOP developer app.Required
  • WHOOP_REDIRECT_URIOAuth redirect URI, exactly as registered on the WHOOP app (e.g. http://localhost:8765/callback).Required
  • WHOOP_DB_URLPostgres DSN the server syncs into and reads from (e.g. postgresql://user:pass@localhost:5432/whoop). Tokens are stored in this database.Required

Pricing

Open source

WHOOP MCP FAQ

Is WHOOP MCP free?

Yes. WHOOP MCP is open source, so you can use and self-host it for free.

How do I add WHOOP MCP to Claude Code?

Run this command in your terminal: claude mcp add whoop-postgres-mcp --env WHOOP_CLIENT_ID='<WHOOP_CLIENT_ID>' --env WHOOP_CLIENT_SECRET='<WHOOP_CLIENT_SECRET>' --env WHOOP_REDIRECT_URI='<WHOOP_REDIRECT_URI>' --env WHOOP_DB_URL='<WHOOP_DB_URL>' -- uvx whoop-postgres-mcp

What are the best alternatives to WHOOP MCP?

The closest alternatives to WHOOP MCP are Midplane, PlatypusDB, Lorebase, Sovaria and model2data studio.

Alternatives to WHOOP MCP

  1. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  2. PlatypusDB

    MCP server

    Gives MCP clients access to your PlatypusDB database connections, scoped per agent

    Runs locally
    • Open source
    • Databases
  3. Lorebase

    MCP server

    Lets agents read and change a governed, versioned Postgres knowledge graph

    Runs locally
    • Open source
    • Knowledge and memory
  4. Sovaria

    MCP server

    Manage a Sovaria backend (Postgres, auth, storage, functions) from an AI assistant

    Not checked yet
    • 4 tools
    • Remote
    • Freemium
    • Databases
  5. Generate realistic connected test data, dbt projects and dashboards from a schema

    • Remote
    • Freemium
    • Databases
  6. semlayer

    MCP server

    Infers a semantic layer from your data warehouse and serves it to agents

    Runs locally
    • Free
    • Databases