davidmosiah avatar

Whoop Mcp

davidmosiah/whoop-mcp

Connects Claude to your WHOOP recovery, sleep, strain, and HRV data through the official OAuth API. Stores tokens locally so credentials never leave your machine. Exposes tools like whoop_daily_summary, whoop_wellness_context, and whoop_list_recoveries that return structured JSON or markdown summaries of your physiology. Includes whoop_demo for testing with synthetic data before you wire up OAuth. Reach for this when you want your agent to reason about training load, sleep debt, or readiness without manually copying numbers from the WHOOP app. Setup takes about 60 seconds once you create a WHOOP Developer app. Part of the Delx Wellness suite of local-first health connectors.

GitHub stars
15
tools
23
auth
Secret needed
transport
STDIO
env vars
8
last updated
Jul 3, 2026

Tools

23 tools

Public tool metadata for what this MCP can expose to an agent.

whoop_demorealistic **synthetic** recovery/sleep/strain payloads, no OAuth needed

realistic **synthetic** recovery/sleep/strain payloads, no OAuth needed

No parameter schema in public metadata yet.

whoop_connection_statusverify local setup before calling WHOOP

verify local setup before calling WHOOP

No parameter schema in public metadata yet.

whoop_data_inventoryinventory supported data domains, scopes, privacy modes and recommended first calls without calling WHOOP APIs.

inventory supported data domains, scopes, privacy modes and recommended first calls without calling WHOOP APIs.

No parameter schema in public metadata yet.

whoop_daily_summaryreadiness, sleep, load and action candidates for today

readiness, sleep, load and action candidates for today

No parameter schema in public metadata yet.

whoop_weekly_summaryscorecard, comparison vs prior week, next-week plan

scorecard, comparison vs prior week, next-week plan

No parameter schema in public metadata yet.

whoop_capabilities

No parameter schema in public metadata yet.

whoop_agent_manifest

No parameter schema in public metadata yet.

whoop_privacy_audit

No parameter schema in public metadata yet.

whoop_cache_status

No parameter schema in public metadata yet.

whoop_get_auth_url

No parameter schema in public metadata yet.

whoop_exchange_code

No parameter schema in public metadata yet.

whoop_revoke_access

No parameter schema in public metadata yet.

whoop_get_profile

No parameter schema in public metadata yet.

whoop_get_body_measurements

No parameter schema in public metadata yet.

whoop_list_recoveriespaginated, with start/end filters and privacy-mode override

paginated, with start/end filters and privacy-mode override

No parameter schema in public metadata yet.

whoop_list_sleepspaginated, with start/end filters and privacy-mode override

paginated, with start/end filters and privacy-mode override

No parameter schema in public metadata yet.

whoop_list_cyclespaginated, with start/end filters and privacy-mode override

paginated, with start/end filters and privacy-mode override

No parameter schema in public metadata yet.

whoop_list_workoutspaginated, with start/end filters and privacy-mode override

paginated, with start/end filters and privacy-mode override

No parameter schema in public metadata yet.

whoop_get_cycle

No parameter schema in public metadata yet.

whoop_get_sleep

No parameter schema in public metadata yet.

whoop_get_workout

No parameter schema in public metadata yet.

whoop_get_cycle_sleep

No parameter schema in public metadata yet.

whoop_get_cycle_recovery

No parameter schema in public metadata yet.

Sponsors

Configuration

WHOOP_CLIENT_ID

WHOOP OAuth client ID. Optional when configured with whoop-mcp-server setup.

WHOOP_CLIENT_SECRETsecret

WHOOP OAuth client secret. Prefer whoop-mcp-server setup so this secret is stored in ~/.whoop-mcp/config.json instead of MCP client config.

WHOOP_REDIRECT_URI

Redirect URI configured in the WHOOP Developer Dashboard. Optional when configured with whoop-mcp-server setup.

WHOOP_TOKEN_PATH

Optional local path for OAuth tokens. Defaults to ~/.whoop-mcp/tokens.json.

WHOOP_PRIVACY_MODE

Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full WHOOP API payloads, not raw device sensor streams.

WHOOP_CACHE

Optional SQLite cache toggle. Set to true or sqlite to enable.

WHOOP_CACHE_PATH

Optional local SQLite cache path. Defaults to ~/.whoop-mcp/cache.sqlite.

WHOOP_NO_CACHE

Set to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless.

Readme

WHOOP MCP

WHOOP MCP — WHOOP MCP for AI agents

Give your AI agent your WHOOP recovery, sleep, strain and HRV — without copy-pasting from the app.
Local-first MCP server — tokens never leave your machine.


View the full README on GitHub

Details

Repository
github.com/davidmosiah/whoop-mcp
Website
wellness.delx.ai/connectors/whoop
Package
whoop-mcp-unofficial
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from davidmosiah