Skip to main content
Glama
oOh91680

whoop-ai-mcp

by oOh91680
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

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.

Related MCP server: whoop-ai-mcp

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.

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. Race results and workout corrections are saved only to local files, with an audit log.

  • 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

In standard mode, the server provides 16 read-only tools, 4 resources and 5 prompt templates, plus 9 HYROX and triathlon tools. Support for resources, prompts and remote connections depends on your assistant.

HYROX and triathlon tracking

Ask "How did yesterday's HYROX sim go?" or "Am I ready for my triathlon in two weeks?" The race tools:

  • Rebuild a HYROX session from WHOOP's back-to-back workouts: segment timeline, transition time, time in zone and rule-based insights.

  • Track weekly running and HYROX load, swim/bike/run balance and bricks, plus logged races with station and leg splits and PRs.

  • Give a readiness band from recovery, training form, specificity, sleep debt and taper. Every component shows its evidence; there's no opaque score.

  • Let you audit the numbers: suspect workouts are flagged, you can relabel or exclude workouts, every change is logged, and verify_claim recomputes a number your assistant told you.

  • Open a chart-first local dashboard (open_performance_dashboard) on 127.0.0.1 with Today, Session, Training, HYROX, Triathlon, Readiness and Audit views. Dark/light themes, local fonts, and review-before-save controls are included.

New in 1.0.2: the chart-first dashboard

Ask your assistant to "Open my performance dashboard" to launch it locally. The design from the latest main-branch redesign is now part of the working dashboard, not just a prototype. Dark is the default, with a Light/Dark toggle that preserves unsaved forms. Session remains the default view.

  • Today: recovery ring and five weeks of recovery, HRV, resting HR and sleep stages on one timeline with a shared crosshair. Missing days remain gaps; historical bands describe your visible data, not medical norms.

  • Training: WHOOP zone minutes by UTC week, including empty weeks, workout strain/duration bubbles and fitness/fatigue/form charts. Local corrections apply.

  • Session and Readiness: recorded-segment and five-component rings, summary HR charts and evidence. No invented continuous HR traces or HYROX station splits.

  • Review before saving. Inspect workout corrections and race results, then edit, cancel or confirm. Failed saves preserve your entries.

  • Keep your context. Filters survive switching views; last-7-day and last-28-day presets use completed UTC days.

  • Refresh honestly. Refresh and retry controls report when a view loaded, not when WHOOP synced. Reads may use cached data.

The race log, workout corrections and dashboard are available only when the server runs locally (stdio). Details: race performance tools and local data.

Group

Tools

Today and baselines

get_today, get_baselines, get_sleep_debt

Trends and reviews

get_weekly_summary, get_trend, compare_periods, get_calendar

Records

get_recovery_collection, get_sleep_collection, get_workout_collection, get_cycle_collection, get_sleep_by_id, get_workout_by_id, get_cycle_by_id

Profile

get_profile, get_body_measurement

HYROX and triathlon

get_hyrox_session_report, get_hyrox_performance, get_triathlon_performance, get_race_readiness, audit_performance_data, verify_claim

Local only: race log, corrections, dashboard

log_race_result, annotate_workout, open_performance_dashboard

Prompt templates: weekly_health_review, sleep_analysis, recovery_trend, workout_recap, health_check

Parameters, date expressions, resources and caching are in the tool reference.

Documentation

Guide

What's in it

Installation

Assistants, manual configuration, environment variables and WHOOP authorization

Tool reference

Every tool and its parameters, date expressions, resources, prompts and caching

Privacy

Structured results, aggregate mode and what your assistant provider receives

Telemetry

Consent, opting out, what's collected and how long it's kept

Troubleshooting

Local diagnostics, common errors and MCP Inspector

Deployment

Docker, cloud hosting and remote connector OAuth

Development

Tests, project structure and release workflow

Background

Ecosystem research and the video walkthrough

What changed recently? See the changelog or the latest release.

Feedback and contributing

Something not working, or a question you wish you could ask? Use the buttons above. Each opens a short form that asks for the details needed to help. Issues are public, so never include credentials or health records; security problems go through the security policy instead.

Want to contribute code? Read the contributing guide. Everyone taking part follows the Code of Conduct.

If whoop-ai-mcp is useful to you, a GitHub star helps other people find it, and you can buy me a coffee to support development.

License

MIT. This is an unofficial project and isn't affiliated with WHOOP. A WHOOP membership and API access are separate from this package.

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

ActivityActive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • 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.
    7 npm
    -

  • whoop-ai-mcp

    catherineweiss219
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants such as Claude, Codex, and GitHub Copilot to query your WHOOP recovery, sleep, HRV, strain, and workout history read-only, including personal baselines, trends, sleep debt, and HYROX or triathlon performance reviews. It runs locally, requires no data exports, and can limit sharing to aggregate summaries.
    7 npm
    -

  • whoop-ai-mcp

    giuseppericcardi613
    F
    license
    Not graded
    quality
    A
    maintenance
    Grants AI assistants read-only access to your WHOOP recovery, sleep, HRV, strain, and workout history so you can ask natural-language questions about daily readiness, personal baselines, sleep debt, trends, and weekly reviews. It also rebuilds HYROX and triathlon sessions, tracks race load and readiness, and runs a local dashboard for auditing and correcting performance data.
    7 npm
    -

  • whoop-ai-mcp

    VirginieSilvestri
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables users to ask their AI assistant about WHOOP recovery, sleep, HRV, strain, and workouts, with baselines, trends, period comparisons, and weekly health reviews drawn from their own recorded history. It also provides HYROX and triathlon race reports, readiness bands, and data auditing through read-only tools, resources, and prompt templates.
    7 npm
    MIT