# WHOOP MCP

> WHOOP MCP is an open-source MCP server for databases. Sync WHOOP recovery, sleep, strain, and workouts into Postgres and query them from any MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/cunicopia-dev/whoop-mcp
- **MCP Registry name:** io.github.cunicopia-dev/whoop-postgres-mcp
- **Categories:** databases
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [PlatypusDB](https://ai-powered.com/mcp/platypusdb): PlatypusDB is an open-source MCP server for databases.
- [Lorebase](https://ai-powered.com/mcp/lorebase): Lorebase is an open-source MCP server for knowledge and memory.
- [Sovaria](https://ai-powered.com/mcp/sovaria): Sovaria is a freemium MCP server for databases.
- [model2data studio](https://ai-powered.com/mcp/model2data-studio): model2data studio is a freemium MCP server for databases.
- [semlayer](https://ai-powered.com/mcp/semlayer): semlayer is a free MCP server for databases.
- [bricksentry](https://ai-powered.com/mcp/bricksentry): bricksentry is an open-source MCP server for databases.
- [MCP Toolbox for Databases](https://ai-powered.com/mcp/mcp-toolbox-for-databases-2): MCP Toolbox for Databases is an open-source MCP server for databases.

---
Source: https://ai-powered.com/mcp/whoop-mcp-3
