Whoop MCP Server - install, status & alternatives [2026]

01 · Install Whoop

before you install - you'll need

Set WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET, WHOOP_REDIRECT_URI, MCP_AUTH_TOKEN, MCP_TRUST_PROXY, MCP_CONNECTOR_PASSWORD, PUBLIC_URL, ALLOWED_REDIRECT_URIS, MCP_ALLOWED_ORIGINS before connecting.

Claude Code

claude mcp add shashankswe2020-ux-whoop-mcp -- npx -y whoop-ai-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "shashankswe2020-ux-whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-ai-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package whoop-ai-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.shashankswe2020-ux is GitHub-verified and matches the repo owner

03 · What Whoop can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get the authenticated user's basic profile - name and email, get the user's body measurements - height, weight, and max heart rate, get recovery scores for a date range. Returns HRV, resting heart rate, SpO2, and skin temp for each day, and get sleep records for a date range. Returns sleep stages, duration, respiratory rate, and performance scores.

Capability map

Tools grouped from the project's README - what Whoop lets an agent do.

read & search

8 tools - e.g. Get the authenticated user's basic profile - name and email.; Get the user's body measurements - height, weight, and max heart rate.; Get recovery scores for a date range. Returns HRV, resting heart rate…

get_profile · get_body_measurement · get_recovery_collection · get_weekly_summary · get_trend · get_today…

Sleep

3 tools - e.g. Get sleep records for a date range. Returns sleep stages, duration, respiratory rate, and performance scores.; Get a single sleep record by ID. Returns sleep stages, duration, respiratory rate, and…

get_sleep_collection · get_sleep_by_id · get_sleep_debt

Workout

2 tools - e.g. Get workout records for a date range. Returns strain, heart rate zones, calories, and sport type.; Get a single workout record by ID. Returns strain, heart rate zones, calories, and sport type.

get_workout_collection · get_workout_by_id

Cycle

2 tools - e.g. Get physiological cycles for a date range. Returns strain, calories, and heart rate data per cycle.; Get a single physiological cycle by ID. Returns strain, calories, and heart rate data.

get_cycle_collection · get_cycle_by_id

Compare

1 tool - e.g. Compare health metrics between two time periods - shows improvement or regression in recovery, sleep, and strain.

compare_periods

Latest releases

v0.7.0 · 2026-09-10

Trustworthy Personal Analytics · Added · get_baselines: personal percentile bands with baseline self-exclusion, calibration filtering, minimum sample counts and explicit truncation. · get_sleep_debt: observed nightly…

v0.6.0 · 2026-06-13

Added · Setup wizard supports Codex & GitHub Copilot - whoop-ai-mcp setup --client=codex prints a codex mcp add command (registers the server in ~/.codex/config.toml) and --client=copilot prints a code --add-mcp…

v0.5.2 · 2026-06-03

Security · OAuth openBrowser URL scheme validation (#151) - reject non-HTTP(S) URL schemes (javascript:, file:, vbscript:, malformed URLs) BEFORE spawning the child process. Defense-in-depth; the URL is constructed…

04 · Who maintains Whoop

whoop is maintained by shashankswe2020-ux. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/shashankswe2020-ux/whoop-mcp
category: API integration - ranked #28 of 278 actively-maintained API integration servers as of 2026-09-18.
release cadence: 1 release in the last 90 days (latest 2026-09-10)
registry: io.github.shashankswe2020-ux/whoop (active, first published 2026-04-16 · 3 versions)
packages: npm:whoop-ai-mcp

06 · Whoop FAQ

Is Whoop still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-10 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Whoop do?

With this server connected, an agent can get the authenticated user's basic profile - name and email, get the user's body measurements - height, weight, and max heart rate, get recovery scores for a date range. Returns HRV, resting heart rate, SpO2, and skin temp for each day, and get sleep records for a date range. Returns sleep stages, duration, respiratory rate, and performance scores.

How do I install Whoop?

Run `npx -y whoop-ai-mcp`. The README documents 9 environment variables (WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET, WHOOP_REDIRECT_URI…) to set first. Set WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET, WHOOP_REDIRECT_URI, MCP_AUTH_TOKEN, MCP_TRUST_PROXY, MCP_CONNECTOR_PASSWORD, PUBLIC_URL, ALLOWED_REDIRECT_URIS, MCP_ALLOWED_ORIGINS before connecting. You can also paste the ready-made client config above.

Does Whoop run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Whoop

Alternatives to Whoop

Maintained API integration servers if Whoop isn't the fit.

More API integration MCP servers · Ckb · Site Shot · Dsh Novel Writer - 网文写作体检 · Federal Compass MCP · OeBB (Austrian Railways)

More TypeScript MCP servers · Constellation · Image · Local RAG (shinpr) · Sub Agents MCP · L402 Kit · see all