# Whoop MCP Server

Gives your AI agent live WHOOP data: recovery, sleep, strain, workouts. Self-hosted, encrypted tokens, no history stored — you deploy it, set the password, and approve each app.

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

## What it does

The server exposes six tools: morning briefing (`get_today`), recovery trends with resting heart rate and SpO2 (`get_recovery_trends`), sleep breakdown by stages and cycles (`get_sleep_analysis`), strain and steps history (`get_strain_history`), workout list with heart-rate zones and elevation (`get_workouts`), and a link to connect your WHOOP account (`get_auth_url`). Every request hits the WHOOP API live — data is always current. The server stores only signed sessions and encrypted refresh tokens; no metrics are cached.

Access is OAuth 2.1: each app asks for the password you set in `MCP_AUTH_PASSWORD` and connects only after you approve it. Without a WHOOP Developer account and two keys (`WHOOP_CLIENT_ID`, `WHOOP_CLIENT_SECRET`), the server refuses to start. The author recommends Railway (template ready, volume mounted), but the Docker image `ghcr.io/yuridivonis/whoop-mcp-server:1` runs anywhere. You need a volume at `/data`; without it, every redeploy clears sessions.

Independent project, MIT license, not endorsed by WHOOP.

## Requirements
- Needs: Docker
- Environment variables: `WHOOP_CLIENT_ID`, `WHOOP_CLIENT_SECRET`, `WHOOP_REDIRECT_URI`, `MCP_AUTH_PASSWORD`, `PUBLIC_URL`, `ENCRYPTION_SECRET`, `UPDATE_CHECK` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- get a morning briefing: recovery, last night's sleep, today's strain
- analyze sleep for a week with stages, cycles and sleep need
- pull resting heart rate, HRV and skin temperature trends for a period
- list workouts with heart-rate zones and distance
- give an agent access to WHOOP data without a public API key

## Example prompts
- How did I sleep this week?
- Show me recovery and resting heart rate for the past seven days
- What's my strain and calories for today?

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
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