How do I install Totem?

Totem is a local plugin. Install it using npm package: @briangaoo/totem and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Totem need?

Totem requires the following credentials or environment variables: WHOOP_IOS_BEARER_TOKEN, WHOOP_COGNITO_REFRESH_TOKEN, WHOOP_EMAIL, WHOOP_USER_ID, WHOOP_TIMEZONE. You can find setup instructions on the server detail page.

What AI apps work with Totem?

Totem uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Totem MCP Server

by Briangaoo

Developer ToolsLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

What You'll Need

Set these up before or after installing:

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

Environment variable: WHOOP_IOS_BEARER_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.Required

Environment variable: WHOOP_COGNITO_REFRESH_TOKEN

Your Whoop account email. Used only by `totem auth` — the running server reads tokens, not credentials.Optional

Environment variable: WHOOP_EMAIL

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

Environment variable: WHOOP_USER_ID

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).Optional

Environment variable: WHOOP_TIMEZONE

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-briangaoo-totem": {
      "env": {
        "WHOOP_EMAIL": "your-whoop-email-here",
        "WHOOP_USER_ID": "your-whoop-user-id-here",
        "WHOOP_TIMEZONE": "your-whoop-timezone-here",
        "WHOOP_IOS_BEARER_TOKEN": "your-whoop-ios-bearer-token-here",
        "WHOOP_COGNITO_REFRESH_TOKEN": "your-whoop-cognito-refresh-token-here"
      },
      "args": [
        "-y",
        "@briangaoo/totem"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Totem MCP Server

About

Security Report

Findings (1)

What You'll Need

How to Install

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MarkItDown

FinAgent