WHOOP MCP server

whoop-mcp

<!-- mcp-name: io.github.cunicopia-dev/whoop-postgres-mcp -->

An MCP server that syncs your WHOOP data into Postgres and lets AI agents query it.

WHOOP's public API is rate-limited, cursor-paginated, and returns one record at a time. That is fine for a sync job and terrible for an agent that wants to answer "how does my HRV this week compare to my baseline?". So this server splits the job in two:

measurements from the WHOOP API into a documented Postgres schema, keeping the raw JSON of every record alongside the typed columns;

• a sync path that pulls cycles, recovery, sleep, workouts, and body

hit WHOOP's rate limits, and keep working offline once data is synced.

• a query path of MCP tools that read Postgres only. They are fast, never

Your data lands in a database you own, in a schema you can read with any SQL client, and nothing leaves your machine except calls to WHOOP itself.

Python 3.12+ · MIT · stdio MCP server + CLI · Postgres storage

Contents

• Tools
• Install
• Quickstart
• Configuration
• Register with an MCP client
• How sync works
• Security model
• Development
• Project layout
• License

Tools

Two write-side tools talk to the WHOOP API; everything else reads Postgres only.

days is capped at 365 and limit at 200. All tools return JSON text.

Install

uv tool install whoop-postgres-mcp      # or: pipx install whoop-postgres-mcp

Or run it without installing:

uvx whoop-postgres-mcp --help

You also need a Postgres database (any recent version; 14+ is fine) and a WHOOP developer app. docs/SETUP.md walks through both.

Quickstart

export WHOOP_CLIENT_ID=...
export WHOOP_CLIENT_SECRET=...
export WHOOP_REDIRECT_URI=http://localhost:8765/callback
export WHOOP_DB_URL=postgresql://whoop:whoop@localhost:5432/whoop

whoop-mcp init-db          # create the `whoop` schema (idempotent)
whoop-mcp auth-url         # print the URL to visit; approve access in a browser
whoop-mcp connect <code>   # paste the `code` from the redirect URL
whoop-mcp sync --all       # first backfill; later runs: whoop-mcp sync --days 7
whoop-mcp                  # serve MCP over stdio

Shortened. The full README is on GitHub.