gitwtfhub

wtf is whoop-mcp-server?

zayden16/whoop-mcp-server — explained in plain English

Analysis updated 2026-05-18

0GoAudience · developerComplexity · 2/5LicenseSetup · moderate

TL;DR

An MCP server that lets AI assistants like Claude read your Whoop fitness tracker data, including recovery, sleep, strain, and workouts.

Mindmap

mindmap
  root((whoop-mcp-server))
    What it does
      Connects Claude to Whoop
      Exposes fitness tools
      Returns raw API data
    Tech stack
      Go
      MCP protocol
      Whoop API v2
    Use cases
      Check recovery score
      Review sleep data
      Track workout strain
    Audience
      Whoop users
      Claude Code users
      Quantified self fans
    Setup
      Whoop developer app
      OAuth login
      Register with Claude

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Ask Claude for your recovery score, sleep quality, or daily strain without opening the Whoop app.

REASON 2

Build a coaching or habit assistant that pulls real Whoop metrics into its answers.

REASON 3

Track average strain over a custom time window automatically.

REASON 4

Pull raw Whoop data, cycles, sleep stages, and workouts, into any MCP-compatible AI tool.

What's in the stack?

GoMCPWhoop API

How it stacks up

zayden16/whoop-mcp-server42wim/fabio42wim/go-xmpp
Stars0
LanguageGoGoGo
Last pushed2018-02-042020-01-24
MaintenanceDormantDormant
Setup difficultymoderatemoderatemoderate
Complexity2/53/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires creating a Whoop developer app and completing a one-time OAuth login.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

whoop-mcp-server connects an AI assistant like Claude to your Whoop fitness tracker data. It is built with the Model Context Protocol, or MCP, which is a way for tools like Claude Code or Claude Desktop to call out to small helper programs and get real information back instead of guessing. This project acts as that helper program for anyone who wears a Whoop band. It talks to the official Whoop API and exposes your health data as a set of tools an assistant can call: your profile, body measurements, daily cycles, recovery scores, sleep stages, and workouts. Each tool returns the same data shapes Whoop's own API provides, so nothing is simplified or hidden, all the detail Whoop tracks, such as heart rate, strain, and sleep stage durations, stays available to the model. There is also a built in tool for calculating your average strain over a chosen number of days. Setting it up takes a few steps. You first register a small app on Whoop's developer site to get a client ID and secret, then install the server itself, using Homebrew, a prebuilt binary, or building from source with Go. After that you run a one time authorization command that opens a browser so you can log into Whoop and grant access. The resulting login token is saved locally and refreshes itself automatically from then on. The final step is registering the server with Claude Code or Claude Desktop by pointing it at the installed program along with your Whoop credentials. Once connected, you can ask plain questions like what is my recovery score today, show my sleep for the past week, or what is my average strain over the last seven days, and the assistant will pull real answers from your Whoop account. The project is released under the MIT license and is written in Go.

Yoink these prompts

Prompt 1
Set up whoop-mcp-server and register it with Claude Code so I can ask about my Whoop stats.
Prompt 2
What's my recovery score today according to my Whoop data?
Prompt 3
Show me my sleep for the past week using the whoop-mcp-server tools.
Prompt 4
Calculate my average strain over the last 7 days.

Frequently asked questions

wtf is whoop-mcp-server?

An MCP server that lets AI assistants like Claude read your Whoop fitness tracker data, including recovery, sleep, strain, and workouts.

What language is whoop-mcp-server written in?

Mainly Go. The stack also includes Go, MCP, Whoop API.

What license does whoop-mcp-server use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is whoop-mcp-server to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is whoop-mcp-server for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.