Install Totem in Gemini CLI
What you need first
- Gemini CLI, installed.
- Node.js, which
gives the
npxcommand the server starts with. - Your own values for
YOUR_WHOOP_IOS_BEARER_TOKEN,YOUR_WHOOP_COGNITO_REFRESH_TOKEN,YOUR_WHOOP_EMAIL.
Steps
- Open
~/.gemini/settings.json, or create it. For one project only, use.gemini/settings.jsonin that project. - Add this block. If the file already has
mcpServers, add only the entry inside it.
{
"mcpServers": {
"totem": {
"command": "npx",
"args": ["-y", "@briangaoo/[email protected]"],
"env": { "WHOOP_IOS_BEARER_TOKEN": "YOUR_WHOOP_IOS_BEARER_TOKEN", "WHOOP_COGNITO_REFRESH_TOKEN": "YOUR_WHOOP_COGNITO_REFRESH_TOKEN", "WHOOP_EMAIL": "YOUR_WHOOP_EMAIL" }
}
}
} - Replace
YOUR_WHOOP_IOS_BEARER_TOKEN,YOUR_WHOOP_COGNITO_REFRESH_TOKEN,YOUR_WHOOP_EMAILwith your own values. - Save the file and restart Gemini CLI.
Check it worked
Ask Gemini CLI: List the tools of totem.
If it does not start
- spawn npx ENOENT
- Node.js is not on the PATH that Gemini CLI sees. Install it, or write the
full path of
npxin the config. - The server starts, but its tools fail
- A
YOUR_…placeholder is still in the config, or its value is wrong. - Nothing changes after a restart
- The file is not valid JSON any more. Look for a missing comma where the block was added.