Skip to main content
Glama
Sign In
WHOOP MCP

WHOOP MCP

by aryanranderiya
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

WHOOP MCP

A Model Context Protocol server that gives LLM agents read-only access to your WHOOP data — recovery, sleep, strain, workouts, and profile.

Built on mcp-use. Hosted at https://calm-forge-de2rt.run.mcp-use.com/mcp.

It is not a 1:1 wrapper of the WHOOP REST API. Following "stop converting REST APIs to MCP", tools are curated for agents: one major context tool, token-efficient trimmed responses, unit-converted values (minutes/hours, kcal), and strict input/output schemas — so the model spends fewer round trips and less context.

Tools

Tool

What it returns

whoop_overview

Start here. One-call snapshot: latest recovery, last sleep, current day strain, profile + body.

whoop_recovery

Recovery history (recovery %, HRV ms, resting HR, SpO2, skin temp). Default last 7 days.

whoop_sleep

Sleep history (performance/efficiency/consistency %, hours slept, stage minutes, respiratory rate, sleep need). Default last 7 days.

whoop_strain

Daily strain history (strain 0-21, avg/max HR, kcal). Default last 7 days.

whoop_workouts

Workout history (sport, strain, avg/max HR, kcal, duration, distance, HR-zone minutes). Default last 14 days.

whoop_profile

Profile + body measurements (name, email, height, weight, max HR).

whoop_get_cycle

One cycle by id, with its recovery and sleep for full day context.

whoop_get_sleep

One sleep activity by UUID.

whoop_get_workout

One workout by UUID.

History tools accept days (lookback window) or explicit start/end ISO-8601 dates, plus an optional limit (max 25). Internal pagination is hidden.

Related MCP server: whoop-ai-mcp

Authentication

WHOOP uses OAuth 2.0 but does not support Dynamic Client Registration, PKCE-S256 advertisement, or resource indicators — all of which spec-compliant MCP clients require. This server bridges that gap with mcp-use's oauthProxy: it advertises a compliant authorization server (DCR + S256 + protected-resource metadata) and proxies the PKCE flow through to WHOOP's real OAuth. WHOOP issues opaque tokens, so a custom verifyToken validates them against GET /v2/user/profile/basic (cached briefly).

The client connects to /mcp, completes WHOOP consent, and each tool call uses that user's WHOOP access token (ctx.auth.accessToken). The proxy is stateless — no token store required.

WHOOP app setup

In the WHOOP developer dashboard:

  • Redirect URI: https://calm-forge-de2rt.run.mcp-use.com/oauth/callback (add http://localhost:3000/oauth/callback too for local OAuth testing).

  • Scopes: read:recovery read:cycles read:sleep read:workout read:profile read:body_measurement offline.

  • Webhook URL: not used — leave blank.

Environment

Copy .env.example to .env:

WHOOP_CLIENT_ID=...
WHOOP_CLIENT_SECRET=...
MCP_URL=https://calm-forge-de2rt.run.mcp-use.com   # local: http://localhost:3000

MCP_URL sets the OAuth redirect_uri (<MCP_URL>/oauth/callback).

Develop

npm install
npm run dev        # boots on http://localhost:3000, inspector at /inspector
npm test           # transform-layer unit tests
npm run typecheck  # tsc --noEmit (strict)

Deploy (Manufact Cloud)

npx @mcp-use/cli login
npm run deploy -- --env-file .env

Manufact assigns a *.run.mcp-use.com URL (this server is at https://calm-forge-de2rt.run.mcp-use.com). Set MCP_URL to that URL so the OAuth redirect_uri matches. To use your own domain instead, add it under Manufact → Domains (CNAME → deploy.run.mcp-use.com) and point MCP_URL at it.

Connect from a client

Add the server URL https://calm-forge-de2rt.run.mcp-use.com/mcp as a custom MCP server, complete the WHOOP OAuth consent, then ask the agent for your WHOOP status.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • WHOOP MCP Server

      maangy
      A
      license
      A
      quality
      D
      maintenance
      Gives Claude access to your WHOOP health data including recovery, sleep, workouts, cycles, body measurements, and profile via the WHOOP Developer API.
      7
      21 npm
      MIT

    • whoop-ai-mcp

      Nancyu5579
      F
      license
      Not graded
      quality
      A
      maintenance
      Gives AI assistants read-only access to your WHOOP account so you can ask about recovery, sleep, HRV, strain and workouts in natural language. It provides 16 read-only tools, 4 resources and 5 prompt templates for daily check-ins, personal baselines, period comparisons and weekly health reviews.
      21 npm
      -

    • whoop-ai-mcp

      aysehunt499
      F
      license
      Not graded
      quality
      A
      maintenance
      Enables read-only access to your WHOOP recovery, sleep, HRV, strain, workout and body-measurement data from Claude Desktop, Claude Code, Codex or GitHub Copilot, so you can ask natural-language questions about today's status, personal baselines, trends, period comparisons and sleep debt.
      21 npm
      -

    • whoop-ai-mcp

      henderson978
      F
      license
      Not graded
      quality
      A
      maintenance
      Enables users to ask an AI assistant about their WHOOP recovery, sleep, HRV, strain, workouts, and personal health trends, including HYROX and triathlon readiness, using read-only access to their own data.
      21 npm
      -