Whoop Mcp
Wraps Whoop's private iOS API (the one the actual app uses) rather than the public OAuth surface. You get 48 tools covering 311 endpoints across 47 microservices: hypnograms, HRV time series, Strength Trainer logs with the full 372-exercise catalog, 308-behavior journal impact analysis, stress monitor timelines, Whoop Coach chat, smart alarm config, and 14 write operations for logging workouts or journal entries. The public API gives you 13 read-only endpoints (recovery totals, sleep stages, workout strain). This gives you everything else. Requires Whoop login via the included CLI, which handles Cognito token refresh and can deploy to Fly or Railway for cross-device access. Note that using the private API violates Whoop's terms.
- GitHub stars
- 67
- tools
- 54
- auth
- Secret needed
- transport
- STDIO
- env vars
- 5
- last updated
- Jun 1, 2026
Tools
54 toolsPublic tool metadata for what this MCP can expose to an agent.
whoop_today
No parameter schema in public metadata yet.
whoop_day
No parameter schema in public metadata yet.
whoop_daily_brief
No parameter schema in public metadata yet.
whoop_weekly_plan
No parameter schema in public metadata yet.
whoop_profile
No parameter schema in public metadata yet.
whoop_calendar
No parameter schema in public metadata yet.
whoop_recovery
No parameter schema in public metadata yet.
whoop_sleep
No parameter schema in public metadata yet.
whoop_strain
No parameter schema in public metadata yet.
whoop_trend
No parameter schema in public metadata yet.
whoop_trend_pack
No parameter schema in public metadata yet.
whoop_compare
No parameter schema in public metadata yet.
whoop_stress
No parameter schema in public metadata yet.
whoop_sleep_need
No parameter schema in public metadata yet.
whoop_live_hr
No parameter schema in public metadata yet.
whoop_live_state
No parameter schema in public metadata yet.
whoop_live_stress
No parameter schema in public metadata yet.
whoop_activity_now
No parameter schema in public metadata yet.
whoop_workouts
No parameter schema in public metadata yet.
whoop_workout
No parameter schema in public metadata yet.
whoop_sports_catalog
No parameter schema in public metadata yet.
whoop_activity_create
No parameter schema in public metadata yet.
whoop_activity_delete
No parameter schema in public metadata yet.
whoop_lift_prs
No parameter schema in public metadata yet.
whoop_lift_exercise
No parameter schema in public metadata yet.
whoop_lift_progression
No parameter schema in public metadata yet.
whoop_lift_history
No parameter schema in public metadata yet.
whoop_lift_overview
No parameter schema in public metadata yet.
whoop_lift_library
No parameter schema in public metadata yet.
whoop_lift_catalog
No parameter schema in public metadata yet.
whoop_lift_log
No parameter schema in public metadata yet.
whoop_lift_template_save
No parameter schema in public metadata yet.
whoop_lift_custom_exercise
No parameter schema in public metadata yet.
whoop_journal
No parameter schema in public metadata yet.
whoop_journal_catalog
No parameter schema in public metadata yet.
whoop_behavior_impact
No parameter schema in public metadata yet.
whoop_journal_log
No parameter schema in public metadata yet.
whoop_journal_autopop
No parameter schema in public metadata yet.
whoop_cycle
No parameter schema in public metadata yet.
whoop_cycle_log
No parameter schema in public metadata yet.
whoop_symptom_log
No parameter schema in public metadata yet.
whoop_coach_ask
No parameter schema in public metadata yet.
whoop_performance_assessment
No parameter schema in public metadata yet.
whoop_smart_alarm
No parameter schema in public metadata yet.
whoop_smart_alarm_set
No parameter schema in public metadata yet.
whoop_leaderboard
No parameter schema in public metadata yet.
whoop_communities
No parameter schema in public metadata yet.
whoop_hr_zones
No parameter schema in public metadata yet.
whoop_preferences
No parameter schema in public metadata yet.
whoop_hr_zones_set
No parameter schema in public metadata yet.
whoop_profile_update
No parameter schema in public metadata yet.
whoop_hidden_metric
No parameter schema in public metadata yet.
whoop_raw
No parameter schema in public metadata yet.
whoop_endpoints
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
WHOOP_IOS_BEARER_TOKEN*secretWhoop Cognito access token. Obtain via `whoop-mcp auth` from the repo, which prompts for your Whoop email + password + SMS MFA code, then writes both tokens to a local .env. Auto-refreshes every ~24h.
WHOOP_COGNITO_REFRESH_TOKEN*secretWhoop Cognito refresh token (~30 day lifetime). Obtained alongside the bearer token from `whoop-mcp auth`. When this expires, run `whoop-mcp auth` to get a fresh pair.
WHOOP_EMAIL*Your Whoop account email. Used only by `whoop-mcp auth` — the running server reads tokens, not credentials.
WHOOP_USER_IDYour numeric Whoop user ID. Optional — used by whoop_profile and whoop_leaderboard. Avoids one redundant bootstrap call per session if set.
WHOOP_TIMEZONEIANA timezone (e.g., America/Los_Angeles) for response timestamps. Optional — if unset, the server auto-detects from your Whoop profile's timezone_offset field (refreshed hourly).
Readme
totem — 55 tools, 47 microservices, 311 endpoints
Totem gives Claude (or any MCP-compatible AI) full read + write access to your wearable data. Today it speaks Whoop — every metric, through Whoop's private iOS API.
Details
- Repository
- github.com/briangaoo/whoop-mcp
- Categories
- Data & Analytics, Mobile Development
- Package
@briangaoo/whoop-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from briangaoo
Related Data & Analytics MCP servers
View all
Quicken Mac Mcpdweekly/quicken-mac-mcpRead-only access to Quicken For Mac financial data: transactions, spending, and portfolios.55stars
Openaffiliate Mcpaffitor/open-affiliateSearch and discover affiliate programs with agent-ready data and commission details.55stars
Weather MCP Serverisdaniel/mcp_weather_serverproviding weather information, air quality data, and timezone utilities using the Open-Meteo API.50stars
Buildkite Mcp Serverbuildkite/buildkite-mcp-serverMCP server exposing Buildkite API data (pipelines, builds, jobs, tests) to AI tooling and editors.49stars
Trends MCPtrendsmcp-ai/trends-mcpTrend data from Google Trends, YouTube, TikTok, Reddit, Amazon, Wikipedia, npm, Steam and more47stars