Totem MCP server
io.github.briangaoo/totem·v1.4.3·121 starsTotem — talk to your wearables with AI. Today: full Whoop access (48 tools).
121 stars
Reviews
Write oneNobody has reviewed Totem yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Totem tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- –Code scanpackage could not be scannedn/a
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 11 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
Findings (1)
- highPackage @briangaoo/totem not found on npm
code.package-missing
How Totem compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 68/100
- higher than 30% of 48,255 servers
- GitHub stars
- 121
- more than 95% of 28,688 servers
Install Totem in Claude Code, Cursor or VS Code
Runs npx -y @briangaoo/totem on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add totem -- npx -y @briangaoo/totem
What the publisher says
From the Totem repository's README, as published. We do not edit it. Read it on GitHub
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.
▶ 2-min demo — the full totem cloud flow: install → Whoop login → Fly deploy → Claude connector → first query.
55 tools, structured zod-validated outputs, bundled catalogs (372 exercises, 308 behaviors, 203 sports, 311 endpoints), write-safety harness, automatic Cognito token refresh, bounded in-memory read cache. TypeScript 6, Node 24, 278 tests.
Totem is becoming a universal wearables bridge. Whoop is the first adapter — every metric, fully wired. Fitbit, Apple Watch, and Garmin are in progress (contributors welcome). The MCP + projection layer is device-agnostic; an adapter just maps its source into the same shared schemas, so everything below applies to whatever you wear.
Note: this works through Whoop's private iOS API rather than the public OAuth API. That isn't what Whoop's terms allow — see the FAQ if you want the full picture before installing.
Table of contents
- Get Started
- Why this exists
- What it does
- Architecture
- The 55 tools
- Authentication
- Write-safety harness
- Bundled catalogs
- Configuration
- Remote hosting
- Deploying to Hugging Face Spaces (free hosting)
- The totem CLI
- Privacy + security
- Troubleshooting
- Comparison to alternatives
- FAQ
- Disclaimers
- Acknowledgments
Other root-level docs: TOOLS.md (full per-tool reference) · WHOOP.md (full API reference) · CHANGELOG.md · CONTRIBUTING.md · SECURITY.md · LICENSE
Get Started
Prerequisites: Node 24+ and a Whoop account (any membership tier).
git clone https://github.com/thebriangao/totem.git
cd totem && npm install && npx tsc && npm linkShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Totem: common questions
- Is Totem MCP server safe?
- With care: it is graded C, so read the findings first (68/100). Read the Totem safety report
- How do I install Totem?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Totem need an API key?
- Yes. The registry entry asks for
WHOOP_IOS_BEARER_TOKEN,WHOOP_COGNITO_REFRESH_TOKEN. - Is Totem maintained?
- The last commit was 49 days ago (2026-09-16). The latest release is v1.4.3.
- How does Totem compare with other MCP servers?
- safety score 68/100 (higher than 30% of 48,255 servers); github stars 121 (more than 95% of 28,688 servers). Full comparison.