briangaoo avatar

Totem

briangaoo/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 tools

Public 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*secret

Whoop 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*secret

Whoop 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_ID

Your numeric Whoop user ID. Optional — used by whoop_profile and whoop_leaderboard. Avoids one redundant bootstrap call per session if set.

WHOOP_TIMEZONE

IANA 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.

Claude Code Claude Desktop ChatGPT Desktop Codex Gemini CLI any MCP 1.x client


View the full README on GitHub

Details

Repository
github.com/briangaoo/totem
Package
@briangaoo/totem
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from briangaoo