What it does
This is a local Python process that speaks MCP over stdio and exposes WHOOP v2 data, including profile, body measurements, cycles, recoveries, sleeps and workouts, through 17 tools. Authentication uses direct OAuth against a WHOOP developer app that you register yourself. Fetched records are mirrored into a local SQLite cache, and the data can be exported as CSV, JSONL or Parquet. Read tools accept a flag that bypasses the cache and returns live WHOOP API responses. Errors are returned as structured envelopes.
The server is aimed at people who want an LLM such as Claude Desktop or Claude Code to answer questions about their own WHOOP records. Typical uses include syncing the last 30 days, viewing a joined daily summary of cycle, recovery, primary sleep and workouts, and exporting workouts to a file. A bundled analysis skill, whoop-insights, reads the cache, computes personal baselines for HRV, recovery, sleep and strain, flags anomalies, runs two correlations and can produce an HTML dashboard.
The server can be run with uvx without cloning the repository, or installed from source into a virtual environment and registered in the MCP client configuration. Setup requires the uv tool and a WHOOP developer app with OAuth credentials. Data stays on the local machine apart from the authenticated calls made to the WHOOP v2 API. The cache file is created with restricted permissions.
Limitations and requirements
Requires a WHOOP developer app registered by the user, with OAuth authentication. Requires the uv tool for the uvx install path. The server is read-only. The publisher describes it as pre-1.0: tool names, response shapes and error codes are not frozen, and breaking changes may appear in minor version updates. The publisher recommends pinning the minor version in CI.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.AshwanthramKL/whoop-mcp
Read-only WHOOP v2 data for MCP clients, with local SQLite cache and CSV/JSONL/Parquet exports.
v0.8.5As shown on registry.modelcontextprotocol.io when we last read it