Whoop MCP
Privacy-first, unofficial WHOOP MCP server for AI health, sleep, recovery, and performance agents.
Connector by davidmosiah · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/davidmosiah-whoop-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 27 read · 2 write · 1 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 30
Read from the source code; the running server may list different tools.
Read 27 · Look things up without changing anything.
whoop_agent_manifestwhoop_cache_statuswhoop_capabilitieswhoop_connection_statuswhoop_daily_summarywhoop_data_inventorywhoop_demowhoop_get_auth_urlwhoop_get_body_measurementswhoop_get_cyclewhoop_get_cycle_recoverywhoop_get_cycle_sleep
Show 15 more tools
whoop_get_profilewhoop_get_sleepwhoop_get_workoutwhoop_list_cycleswhoop_list_recoverieswhoop_list_sleepswhoop_list_workoutswhoop_onboardingwhoop_privacy_auditwhoop_profile_getwhoop_quickstartwhoop_recovery_trendwhoop_sleep_trendwhoop_weekly_summarywhoop_wellness_context
Write 2 · Create, change, send or run things.
whoop_exchange_codewhoop_profile_update
Delete 1 · Delete, drop, revoke or wipe things.
whoop_revoke_access
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
WHOOP_CLIENT_SECRET
Other settings (environment variables or headers).
WHOOP_CACHEWHOOP_CACHE_PATHWHOOP_CLIENT_IDWHOOP_NO_CACHEWHOOP_PRIVACY_MODEWHOOP_REDIRECT_URIWHOOP_TOKEN_PATH
Network hosts it talks to 8
api.prod.whoop.com· found in codedavidmosiah.github.io· found in codedeveloper.whoop.com· found in codeexample.test· found in codegithub.com· found in codeglama.ai· found in codewellness.delx.ai· found in codewhoopmcp.vercel.app· found in code
Files it touches
- Your home directory (~)
~/.hermes/config.yaml~/.hermes/skills/whoop-mcp/SKILL.md
Tools (30)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
whoop_agent_manifestWHOOP Agent Manifestread-onlyMachine-readable install, runtime and client guidance for AI agents operating the WHOOP MCP. Does not read WHOOP or expose secrets.
whoop_cache_statusWHOOP Cache Statusread-onlyShow optional local SQLite cache status. Enable with WHOOP_CACHE=sqlite or WHOOP_CACHE=true.
whoop_capabilitiesWHOOP MCP Capabilitiesread-onlyExplain supported WHOOP data, unavailable raw sensor streams, privacy modes, recommended agent workflow, and project links. Does not read WHOOP or expose secrets.
whoop_connection_statusWHOOP Connection Statusread-onlyCheck whether local WHOOP env vars, token file, Node version, privacy mode and cache are ready. Does not call WHOOP or expose secrets.
whoop_daily_summaryWHOOP Daily Summaryread-onlyBuild a privacy-conscious daily performance summary from WHOOP recovery, sleep, cycle and workout data. This workflow tool fetches recent WHOOP v2 records, computes a defensive baseline, and returns readiness, sleep, load, diagnostic signals and concrete action candidates. It does not provide medical advice and does not store data locally.
whoop_data_inventoryWHOOP Data Inventoryread-onlyInventory supported WHOOP data domains, auth scope requirements, privacy boundary and recommended first calls. Does not call WHOOP APIs or expose user data.
whoop_demoWHOOP Demoread-onlyReturns realistic example payloads of whoop_daily_summary, whoop_wellness_context, and whoop_list_recoveries so agents see the contract before calling real WHOOP APIs. Shapes are verified against the real tools by a build gate, so a parser written against this demo works on live data.
whoop_exchange_codeExchange WHOOP OAuth CodeExchange a WHOOP OAuth authorization code for local tokens. Tokens are stored locally with 0600 permissions and are never returned by this tool. Gated: requires explicit user intent — agents must not call this autonomously.
whoop_get_auth_urlGet WHOOP OAuth URLread-onlyGenerate a WHOOP OAuth authorization URL. This does not read or modify WHOOP data. Use this first when no local token exists.
whoop_get_body_measurementsGet WHOOP Body Measurementsread-onlyGet the authenticated user's WHOOP body measurements (height, weight, max heart rate). Requires read:body_measurement scope. Not medical advice.
whoop_get_cycleWHOOP Cycleread-onlyGet one WHOOP cycle by numeric cycle id. Requires read:cycles scope.
whoop_get_cycle_recoveryWHOOP Cycle Recoveryread-onlyGet the recovery associated with a WHOOP cycle. Requires read:recovery scope. Not medical advice.
whoop_get_cycle_sleepWHOOP Cycle Sleepread-onlyGet the sleep associated with a WHOOP cycle. Requires read:sleep scope. Not medical advice.
whoop_get_profileGet WHOOP Profileread-onlyGet the authenticated user's basic WHOOP profile. Requires read:profile scope.
whoop_get_sleepWHOOP Sleepread-onlyGet one WHOOP sleep activity by UUID. Requires read:sleep scope. Not medical advice.
Show 15 more tools
whoop_get_workoutWHOOP Workoutread-onlyGet one WHOOP workout by UUID. Requires read:workout scope.
whoop_list_cyclesWHOOP Cyclesread-onlyList WHOOP physiological cycles. Supports start/end filters and WHOOP pagination. Requires read:cycles scope.
whoop_list_recoveriesWHOOP Recoveriesread-onlyList WHOOP recoveries sorted by related sleep start time descending. Returns recovery score, HRV, RHR, SpO2 and skin temperature when scored. Requires read:recovery scope. Not medical advice.
whoop_list_sleepsWHOOP Sleepsread-onlyList WHOOP sleep activities. Returns sleep stages, performance, consistency and efficiency when scored. Supports start/end filters and WHOOP pagination. Requires read:sleep scope. Not medical advice.
whoop_list_workoutsWHOOP Workoutsread-onlyList WHOOP workouts. Supports start/end filters and WHOOP pagination. Requires read:workout scope.
whoop_onboardingWHOOP Onboarding (shared wellness profile)read-onlyReturn the 11-question Delx wellness onboarding flow (in English or pt-BR) plus the current shared profile state and missing critical fields. Read-only. The agent should ask these questions one-by-one, then call whoop_profile_update with explicit_user_intent=true to save. The same profile is reused by every Delx Wellness connector (Oura, Garmin, Nourish, etc.) — agents can call the equivalent {connector}_onboarding tools to cover their respective domains, or rely on this one since all connectors share the same questions.
whoop_privacy_auditWHOOP Privacy Auditread-onlyReturn the local privacy, cache, token-path, env-presence and redaction posture without revealing secret values.
whoop_profile_getWHOOP Profile Get (shared wellness profile)read-onlyRead the shared Delx wellness profile (~/.delx-wellness/profile.json). Returns the user's preferred name, body basics, goals, devices, training context, nutrition context, agent preferences, and missing critical fields. Cross-connector — the same profile is also available from other Delx Wellness MCPs (Oura, Garmin, Nourish, Fitbit, etc). Read-only.
whoop_profile_updateWHOOP Profile Update (shared wellness profile)Persist a partial patch to the shared Delx wellness profile (~/.delx-wellness/profile.json). REQUIRES explicit_user_intent=true. Top-level fields stored: profile (preferred_name, language, timezone, units, age_or_birth_year, height, weight, sex_or_gender_context), goals, devices, training, nutrition, preferences, safety, notes. NEVER stores OAuth tokens, API keys, refresh tokens, cookies, or any secret-shaped field — writes will be rejected at validation time. Cross-connector — the same profile is read by other Delx Wellness MCPs.
whoop_quickstartWHOOP Quickstartread-onlyPersonalized 3-step setup walkthrough for the human user. Adapts to current state (env vars set? token present? what's next?). Call this first when the user asks 'how do I connect WHOOP?'
whoop_recovery_trendWHOOP Recovery Trendread-onlyAggregate WHOOP recovery over the last N days (default 30) into a per-metric trend for recovery score, HRV (hrv_rmssd_milli) and resting heart rate. Each metric returns { avg, min, max, slope, direction, n_valid } where slope is a least-squares fit over the chronologically ordered scored records (oldest to newest) and direction is rising, falling, stable or insufficient_data. Use this to answer "is my recovery trending up or down?" without paging the raw collection yourself. Read-only; fetches recent WHOOP v2 records, computes statistics, stores nothing. Not medical advice.
whoop_revoke_accessRevoke WHOOP OAuth Accesscan change or delete dataRevoke the current WHOOP OAuth access grant and delete the local token file. Use only when the user explicitly wants to disconnect WHOOP. Gated: requires explicit user intent — agents must not call this autonomously.
whoop_sleep_trendWHOOP Sleep Trendread-onlyAggregate WHOOP sleep over the last N days (default 30) into a per-metric trend for sleep performance percentage, sleep duration (hours) and sleep efficiency percentage. Each metric returns { avg, min, max, slope, direction, n_valid } where slope is a least-squares fit over the chronologically ordered scored sleeps (oldest to newest) and direction is rising, falling, stable or insufficient_data. Use this to answer "is my sleep improving or degrading?" without paging the raw collection yourself. Read-only; fetches recent WHOOP v2 records, computes statistics, stores nothing. Not medical advice…
whoop_weekly_summaryWHOOP Weekly Summaryread-onlyBuild a weekly WHOOP operating review with recovery, sleep, strain, workouts, bottlenecks, action candidates and next-week success metrics. This workflow tool compares a recent window against a prior window when available. It is intended for coaching and agent workflows, not medical diagnosis.
whoop_wellness_contextWHOOP Wellness Contextread-onlyNormalize WHOOP recovery, sleep, strain and recent workout load into the shared wellness_context shape for exercise recommendation engines and Telegram agents.
Signals
- Stars
- 14
- Forks
- 7
- Open issues
- 0
- Last commit
- Oct 17, 2026 (12 days ago)
- Last release
- Oct 3, 2026 (26 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.davidmosiah/whoop-mcp- Version
- 0.5.3
- Auth
- API key
- Packages
- npm whoop-mcp-unofficial
- License
- MIT
- Repository
- github.com/davidmosiah/whoop-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from davidmosiah
- 0.598score
Google Health MCP
davidmosiah
Privacy-first unofficial Google Health API v4 MCP server for health, sleep, activity, HR agents
ConnectorAFreshness: ALocal★ 72Claude Code +5 - 0.567score
Samsung Health MCP
davidmosiah
Unofficial local-first MCP server for Samsung Health personal-data CSV/ZIP exports.
ConnectorAFreshness: ALocal★ 16Claude Code +5 - 0.563score
Delx Protocol — Agent Recovery & Continuity
davidmosiah
Free agent recovery and continuity.
ConnectorAFreshness: ARemoteClaude Code +3 - 0.563score
Delx Commerce — Pay-per-Result APIs for Agents
davidmosiah
986 pay-per-result MCP/x402 APIs for web, data, Base, reliability and agent delivery.
ConnectorAFreshness: ARemoteClaude Code +3 - 0.562score
Garminmcp
davidmosiah
Privacy-first unofficial Garmin Connect MCP for AI health, sleep, activity & recovery agents.
ConnectorAFreshness: ALocal★ 13Claude Code +5 - 0.559score
Wellness Nourish
davidmosiah
Local-first nutrition MCP for AI agents: food, barcode, photo, intake, hydration, goals.
ConnectorAFreshness: ALocal★ 11Claude Code +5
Cite this page
Whoop MCP. Agent Mart. https://agentmart.dev/connectors/davidmosiah-whoop-mcp (last updated 2026-10-25)