Skip to content

Whoop MCP

Read-only WHOOP MCP server for recovery, sleep, HRV, strain, workouts, and personal health analytics in Claude, Codex, and GitHub Copilot.

Install

$npx -y whoop-ai-mcp@latest setup --client=claude-desktop
Claude Code
claude mcp add whoop-mcp -- npx -y whoop-ai-mcp@latest setup --client=claude-desktop
Cursor / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-ai-mcp@latest",
        "setup",
        "--client=claude-desktop"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

whoop-ai-mcp is a read-only WHOOP MCP server for Claude Desktop, Claude Code, Codex and GitHub Copilot. Ask about your recovery, compare weeks of sleep, or check today against your own baseline, without exporting the data yourself.

npx -y whoop-ai-mcp@latest setup --client=claude-desktop
<strong>Quickstart</strong>&ensp;|&ensp;Watch the walkthrough&ensp;|&ensp;Website&ensp;|&ensp;Tool reference





Claude Desktop builds the review; whoop-ai-mcp supplies the data. Your results and layout will differ.

Ask your WHOOP data anything

Ask You get
"How am I doing today?" Recovery, primary sleep, strain and your latest workout, with gaps flagged where data is missing
"Is my HRV unusual for me?" Your personal baseline: distribution, percentiles and how many days it's based on
"How did my sleep change this month?" Trends, period-to-period comparisons, sleep debt and consistency
"Give me my weekly health review." Recovery, sleep and training in one summary

Statistics describe your recorded history. They aren't medical diagnoses or predictions.

Quickstart

You need: Node.js 20 or later, an active WHOOP membership, and a WHOOP Developer App with the redirect URL http://localhost:3000/callback.

  1. Set up. Run the command for your assistant and enter your developer app's client ID and secret when asked.

    Assistant Command
    Claude Desktop npx -y whoop-ai-mcp@latest setup --client=claude-desktop
    Claude Code npx -y whoop-ai-mcp@latest setup --client=claude-code
    Codex npx -y whoop-ai-mcp@latest setup --client=codex
    GitHub Copilot npx -y whoop-ai-mcp@latest setup --client=copilot

    For Claude Code, Codex and Copilot, run the registration command that setup prints. Nothing is installed globally, and optional usage telemetry defaults to No.

  2. Authorize. Fully quit and reopen your assistant. The first time the server starts, WHOOP opens in your browser so you can approve access.

  3. Ask. Try "Summarize my sleep and recovery this week."

Need manual configuration, environment variables or a remote deployment? See the full setup guide.

Prefer a native binary?

The Rust implementation supports the same four assistants without a Node.js runtime. It needs Rust 1.88 or later:

cargo install whoop-mcp
whoop-mcp setup --client=claude-desktop

How it works

  • Read-only. The server has no tools that create, change or delete anything in your WHOOP account.
  • Local by default. The server runs on your machine. No hosted relay is involved.
  • Your assistant sees the results. Health data reaches the assistant provider you use, the same as anything else you share in that chat.
  • Aggregate mode limits the server to five summary tools and hides per-record data. It reduces what's shared, but it isn't anonymization.
  • Telemetry is off unless you opt in. It never includes health data or chat text.

Details: data handling and telemetry controls.

What's included

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

Explore related