# whoop

Connects WHOOP health metrics to your AI client, surfacing daily recovery, sleep debt, strain, and baseline trends.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 173
- Author: shashankswe2020-ux
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shashankswe2020-ux/whoop-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/whoop

## What it does

The integration brings 16 read-only utilities directly into your developer assistant. It fetches strain scores, workout logs, sleep cycles, and recovery percentages so you can query your health history conversationally.

Everything executes on your local machine using the `whoop-ai-mcp` package without intermediary relay hosts. Setup requires registering a project in the WHOOP developer portal with `http://localhost:3000/callback` set as the redirect address, then passing your credentials via environment flags.

Without a current WHOOP subscription and Node.js version 20 or higher, the server fails to authenticate. The returned data reflects historical measurements rather than medical evaluations.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `WHOOP_CLIENT_ID`, `WHOOP_CLIENT_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add whoop -e WHOOP_CLIENT_ID=<WHOOP_CLIENT_ID> -e WHOOP_CLIENT_SECRET=<WHOOP_CLIENT_SECRET> -- npx -y whoop-ai-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add whoop --env WHOOP_CLIENT_ID=<WHOOP_CLIENT_ID> --env WHOOP_CLIENT_SECRET=<WHOOP_CLIENT_SECRET> -- npx -y whoop-ai-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "whoop": {
            "command": "npx",
            "args": [
                "-y",
                "whoop-ai-mcp"
            ],
            "env": {
                "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
                "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "whoop": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "whoop-ai-mcp"
            ],
            "env": {
                "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
                "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WHOOP_CLIENT_ID=<WHOOP_CLIENT_ID> -e WHOOP_CLIENT_SECRET=<WHOOP_CLIENT_SECRET> whoop npx -y whoop-ai-mcp
```
Replace <…> with your own values

## When to use it
- check today's strain score and recovery balance
- evaluate HRV percentiles against personal baselines
- track sleep debt changes across multiple weeks
- compile a consolidated weekly training recap

## Example prompts
- How am I doing today based on my recovery and strain?
- Compare my sleep consistency over the last month.
- Give me a breakdown of my workouts and rest from this past week.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md