
Totem
If you want Claude to read your Whoop data beyond the 13 endpoints in the public OAuth API, this taps into the same private iOS backend that powers the actual Whoop app. You get all 311 operations across 47 microservices: hypnograms with per-stage sleep timelines, Strength Trainer lifts and PRs, the 308-behavior journal with impact analysis, intraday stress monitoring, trend data for 25 metrics, Whoop Coach chat, and full read-write on smart alarms and HR zones. It includes a write-safety harness and bundled catalogs for 372 exercises, 308 behaviors, and 203 sports. Note that this uses Whoop's private API against their terms, so understand the trade-off before deploying.
- GitHub stars
- 67
- tools
- 54
- auth
- Secret needed
- transport
- STDIO
- env vars
- 5
- last updated
- Jun 8, 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
Configuration
WHOOP_IOS_BEARER_TOKEN*secretWhoop Cognito access token. Obtain via `totem 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 `totem auth`. When this expires, run `totem auth` to get a fresh pair.
WHOOP_EMAIL*Your Whoop account email. Used only by `totem 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/totem
- Package
@briangaoo/totem- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active