mcpbeat Sign in

Totem MCP Server

by thebriangao Your server? Claim it
local only

Totem runs on your own machine — the client starts it, so there is no endpoint to ping. 34 installs a week from npm. Last commit 16 Sep 2026.

Totem — talk to your wearables with AI. Today: full Whoop access (48 tools).

Installs per day peak 12 · avg 3 · +386% w/w
a month agotoday
34
Installs / week
npm · @thebriangao/totem
139
Stars
3 open issues
16 Sep 2026
Last commit
no releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 3 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] src/whoop/session_state.ts:1
этот файл ставится пользователю, но в репозитории его нет
    const child = spawn(cmd, args, { stdio: "inherit", ...opts });
Secret passed into the image build Dockerfile:44
ENV WHOOP_TOKEN_STORE=memory

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add totem -e 'WHOOP_IOS_BEARER_TOKEN=<WHOOP_IOS_BEARER_TOKEN>' -e 'WHOOP_COGNITO_REFRESH_TOKEN=<WHOOP_COGNITO_REFRESH_TOKEN>' -e 'WHOOP_EMAIL=<WHOOP_EMAIL>' -- npx -y @thebriangao/totem
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "totem": {
      "command": "npx",
      "args": [
        "-y",
        "@thebriangao/totem"
      ],
      "env": {
        "WHOOP_COGNITO_REFRESH_TOKEN": "<WHOOP_COGNITO_REFRESH_TOKEN>",
        "WHOOP_EMAIL": "<WHOOP_EMAIL>",
        "WHOOP_IOS_BEARER_TOKEN": "<WHOOP_IOS_BEARER_TOKEN>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.totem]
command = "npx"
args = ["-y", "@thebriangao/totem"]
env = { WHOOP_IOS_BEARER_TOKEN = "<WHOOP_IOS_BEARER_TOKEN>", WHOOP_COGNITO_REFRESH_TOKEN = "<WHOOP_COGNITO_REFRESH_TOKEN>", WHOOP_EMAIL = "<WHOOP_EMAIL>" }
.cursor/mcp.json
{
  "mcpServers": {
    "totem": {
      "command": "npx",
      "args": [
        "-y",
        "@thebriangao/totem"
      ],
      "env": {
        "WHOOP_COGNITO_REFRESH_TOKEN": "<WHOOP_COGNITO_REFRESH_TOKEN>",
        "WHOOP_EMAIL": "<WHOOP_EMAIL>",
        "WHOOP_IOS_BEARER_TOKEN": "<WHOOP_IOS_BEARER_TOKEN>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "totem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@thebriangao/totem"
      ],
      "env": {
        "WHOOP_COGNITO_REFRESH_TOKEN": "<WHOOP_COGNITO_REFRESH_TOKEN>",
        "WHOOP_EMAIL": "<WHOOP_EMAIL>",
        "WHOOP_IOS_BEARER_TOKEN": "<WHOOP_IOS_BEARER_TOKEN>"
      }
    }
  }
}

Put your own values in place of <WHOOP_IOS_BEARER_TOKEN> (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> (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). The author’s registry entry marks them as required.

Optional settings from the registry entry, left out of the block above: 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)).

Alternatives to Totem

same job, measured the same way
Totem
by briangaoo

Totem — talk to your wearables with AI. Today: full Whoop access (48 tools).

local only
Whoop MCP
by briangaoo

Full read + write access to your Whoop fitness data via the private iOS API. 48 tools.

76 installs/wk local only
Research Connect
by oliveturn

Legitimate full-text access to scholarly articles for your AI, by DOI, with provenance.

answering
Appfigures
by appfigures

Access your app analytics, ASO tools, and app market intelligence with Appfigures.

607 installs/wk answering
aNotepad
by anotepad

AI access to your aNotepad online notes: read, search, write, and organize via 22 tools.

answering
MCPBundles Hub
by mcpbundles

Access all your MCPBundles tools in one place. Unified hub for all enabled bundles.

answering
Questlaw Library
by questlaw

Access your QuestLaw library in GenAI Tools.

49 installs/wk local only
Ref Tools Ref Tools MCP
by smithery

Provide your AI coding tools with token-efficient access to up-to-date technical documentation for…

answering

Totem — questions

Answers built from our own checks of this server.

Why is there no uptime for Totem?
Totem runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @thebriangao/totem was installed 34 times last week.
How do I connect Totem?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @thebriangao/totem straight from npm; nothing to host, nothing to sign up for.
How many people use Totem?
The npm package @thebriangao/totem was installed 34 times in the last week. Week over week that is +386%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Totem open source?
Yes — it is published under the MIT licence, written in TypeScript, 139 stars on GitHub and 3 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.