AI Plugin Index
whoop-mcp
CommunityMCP server by briangaoo · updated · ★ 133
Full read + write access to your Whoop fitness data via the private iOS API. 48 tools. whoop-mcp is a community project by briangaoo, not verified by a company domain.
Install whoop-mcp
Built from the published package, never by AIclaude mcp add whoop-mcp -e WHOOP_IOS_BEARER_TOKEN=YOUR_WHOOP_IOS_BEARER_TOKEN -e WHOOP_COGNITO_REFRESH_TOKEN=YOUR_WHOOP_COGNITO_REFRESH_TOKEN -e WHOOP_EMAIL=YOUR_WHOOP_EMAIL -- npx -y @briangaoo/whoop-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"whoop-mcp": {
"command": "npx",
"args": [
"-y",
"@briangaoo/whoop-mcp"
],
"env": {
"WHOOP_IOS_BEARER_TOKEN": "YOUR_WHOOP_IOS_BEARER_TOKEN",
"WHOOP_COGNITO_REFRESH_TOKEN": "YOUR_WHOOP_COGNITO_REFRESH_TOKEN",
"WHOOP_EMAIL": "YOUR_WHOOP_EMAIL"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"whoop-mcp": {
"command": "npx",
"args": [
"-y",
"@briangaoo/whoop-mcp"
],
"env": {
"WHOOP_IOS_BEARER_TOKEN": "YOUR_WHOOP_IOS_BEARER_TOKEN",
"WHOOP_COGNITO_REFRESH_TOKEN": "YOUR_WHOOP_COGNITO_REFRESH_TOKEN",
"WHOOP_EMAIL": "YOUR_WHOOP_EMAIL"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"whoop-mcp": {
"command": "npx",
"args": [
"-y",
"@briangaoo/whoop-mcp"
],
"env": {
"WHOOP_IOS_BEARER_TOKEN": "YOUR_WHOOP_IOS_BEARER_TOKEN",
"WHOOP_COGNITO_REFRESH_TOKEN": "YOUR_WHOOP_COGNITO_REFRESH_TOKEN",
"WHOOP_EMAIL": "YOUR_WHOOP_EMAIL"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add whoop-mcp --env WHOOP_IOS_BEARER_TOKEN=YOUR_WHOOP_IOS_BEARER_TOKEN --env WHOOP_COGNITO_REFRESH_TOKEN=YOUR_WHOOP_COGNITO_REFRESH_TOKEN --env WHOOP_EMAIL=YOUR_WHOOP_EMAIL -- npx -y @briangaoo/whoop-mcp{
"mcpServers": {
"whoop-mcp": {
"command": "npx",
"args": [
"-y",
"@briangaoo/whoop-mcp"
],
"env": {
"WHOOP_IOS_BEARER_TOKEN": "YOUR_WHOOP_IOS_BEARER_TOKEN",
"WHOOP_COGNITO_REFRESH_TOKEN": "YOUR_WHOOP_COGNITO_REFRESH_TOKEN",
"WHOOP_EMAIL": "YOUR_WHOOP_EMAIL"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add whoop-mcp npx -y @briangaoo/whoop-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the whoop-mcp block.
Last commit 37 days ago
No licence found, so reuse rights are unclear
Clear description, published package or server URL, 133 stars, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
WHOOP_Environment variable, secret | Required | Whoop Cognito access token. Obtain via `whoop-mcp 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_Environment variable, secret | Required | Whoop Cognito refresh token (~30 day lifetime). Obtained alongside the bearer token from `whoop-mcp auth`. When this expires, run `whoop-mcp auth` to get a fresh pair. |
WHOOP_Environment variable | Required | Your Whoop account email. Used only by `whoop-mcp auth` — the running server reads tokens, not credentials. |
WHOOP_Environment variable | Optional | Your numeric Whoop user ID. Optional — used by whoop_profile and whoop_leaderboard. Avoids one redundant bootstrap call per session if set. |
WHOOP_Environment variable | Optional | 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). |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Weekly newsletter
Like whoop-mcp? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to whoop-mcp
All alternatives →
Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Codebase intelligence for AI coding agents — graph, git history, docs, decisions, code health.
MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.
Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.
MCP server for mobile app automation: verify, control, and debug iOS, Android, TV, and desktop apps
whoop-mcp: common questions
How do I install whoop-mcp?
In Claude Code run claude mcp add whoop-mcp -e WHOOP_IOS_BEARER_TOKEN=YOUR_WHOOP_IOS_BEARER_TOKEN -e WHOOP_COGNITO_REFRESH_TOKEN=YOUR_WHOOP_COGNITO_REFRESH_TOKEN -e WHOOP_EMAIL=YOUR_WHOOP_EMAIL -- npx -y @briangaoo/whoop-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is whoop-mcp the official server?
whoop-mcp is a community project by briangaoo, not verified by a company domain.
Is whoop-mcp free?
The code is published under the NOASSERTION licence. The service it connects to may have its own pricing.
Is whoop-mcp safe to use?
It scores 68 of 100. Grades: maintenance B, licence F, quality B. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to whoop-mcp?
Similar MCP servers: mockserver, XcodeBuildMCP, Repowise, SmartBear MCP.
Does whoop-mcp work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.