Back to Browse

Whoop MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

Full read + write access to your Whoop fitness data via the private iOS API. 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. Trust signals: trusted author (4/4 approved).

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

Environment variable: WHOOP_IOS_BEARER_TOKEN

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

Environment variable: WHOOP_COGNITO_REFRESH_TOKEN

Your Whoop account email. Used only by `whoop-mcp 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-whoop-mcp": {
      "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/whoop-mcp"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!