MCP.Market

Whoop MCP server

by AshwanthramKL·io.github.AshwanthramKL/whoop-mcp·v0.8.5
No reviews yet

Read-only WHOOP v2 data for MCP clients, with local SQLite cache and CSV/JSONL/Parquet exports.

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
New

0 stars73 downloads/wk

Reviews

Write one

Nobody has reviewed Whoop yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Whoop tools (17, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • export_whoop

    Export cached WHOOP records to disk.

  • get_whoop_auth_status

    Report WHOOP OAuth token status. Call this first if other WHOOP tools return AUTH_FAILED, to check whether the user needs to re-authorize.

  • get_whoop_body_measurement

    Fetch the user's latest body measurements (height, weight, max HR).

  • get_whoop_cycle

    Fetch a single WHOOP cycle by numeric ID. Cache-first.

  • get_whoop_cycle_recovery

    Fetch the recovery record associated with a given cycle. Cache-first.

  • get_whoop_cycle_sleep

    Fetch the sleep record associated with a given cycle. Cache-first.

  • get_whoop_daily_summary

    Gather a single day's WHOOP data into one flat record.

  • get_whoop_events

    Returns WHOOP records that changed since a given timestamp, across all cached resources.

  • get_whoop_profile

    Fetch the authenticated user's WHOOP profile (name, email).

  • get_whoop_sleep

    Fetch a single sleep activity by UUID. Cache-first.

  • get_whoop_workout

    Fetch a single workout by UUID. Cache-first.

  • health_checkwrite action

    Run server health checks and return a structured status dict.

  • list_whoop_cycles

    List WHOOP physiological cycles in a time window.

  • list_whoop_recoveries

    List WHOOP recovery records in a time window. Cache-first.

  • list_whoop_sleeps

    List WHOOP sleep activities (including naps) in a time window. Cache-first.

  • list_whoop_workouts

    List WHOOP workouts in a time window. Cache-first.

  • sync_whoop

    Refresh the local WHOOP cache.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan13 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 77 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Whoop compares

Against every graded Databases MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 47% of 802 Databases servers
Tools
17
the typical Databases server has 8
Tools that change things
6%
typical: 10%. Fewer write tools means less an agent can break
Downloads a week
73
more than 48% of 328 Databases servers with a package

What its tools let an agent do: 15 read · 2 change

Install Whoop in Claude Code, Cursor or VS Code

claude mcp add whoop-mcp -- uvx whoop-mcp
Add to Cursor

What the publisher says

From the Whoop repository's README, as published. We do not edit it. Read it on GitHub

WHOOP MCP Server

A local Model Context Protocol (MCP) server that gives an LLM read-only access to your WHOOP fitness data. Authentication is direct OAuth against your own WHOOP developer app — there is no third-party proxy in the path. All records are mirrored into a local SQLite cache at ~/.whoop-mcp-server/whoop.db, and no data ever leaves your machine except for the authenticated calls the server itself makes to the WHOOP v2 API.

Current version: 0.8.5 — see CHANGELOG.md.

Pre-1.0 status. The API surface (tool names, response shapes, error

codes) is stabilizing but not frozen. Breaking changes may land in

0.x minor bumps during dogfooding. Patch bumps (0.8.x) are

bugfix-only. 1.0.0 will be cut when the surface has been stable for

2+ weeks of real use. Pin the minor version in CI if you're building

on top of this.

Just want to try it? Copy the prompt in

docs/AGENTINSTALLPROMPT.md, paste

it into Claude Code / Claude Desktop / Cursor / Windsurf, and your

agent will do the install end-to-end.

Building on this repo? Start with AGENTS.md and

docs/ARCHITECTURE.md — they're the

load-bearing conventions and one-page system map.

Table of contents

  • What this is
  • Install (one line via uvx)
  • Install with your agent
  • Install from source
  • Analysis skill: whoop-insights
  • Quick start
  • Tool catalog
  • MCP resources
  • Data model
  • Sync model
  • Event feed
  • Exports

What this is

The WHOOP MCP Server is a small Python process that speaks MCP over stdio. It exposes WHOOP v2 data (profile, body measurement, cycles, recoveries, sleeps, workouts) to any MCP-capable client — primarily Claude Desktop and Claude Code. The server is read-only. It authenticates with WHOOP using an OAuth app you register yourself, so your tokens never travel through a third-party server. The WHOOP records you fetch are written to a local SQLite cache (mode 0o600) so subsequent reads are free and offline, and the cache file never leaves your machine.

Install (one line via uvx)

# 1. Create a WHOOP developer app (one-time, free, self-serve):
#    https://developer-dashboard.whoop.com/apps/create
#    Redirect URI:  http://localhost:8000/callback
#    Scopes:        read:profile read:body_measurement read:recovery
#                   read:cycles read:sleep read:workout offline

# 2. One-shot OAuth — opens browser, catches callback, saves encrypted tokens.
WHOOP_CLIENT_ID="<your client id>" \
WHOOP_CLIENT_SECRET="<your client secret>" \
  uvx --from whoop-mcp whoop-mcp-oauth

# 3. Register with Claude Code. The --env flags are required so the

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Whoop: common questions

Is Whoop MCP server safe?
Mostly: it is graded B (78/100). Read the Whoop safety report
How do I install Whoop?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Whoop need an API key?
Yes. The registry entry asks for WHOOP_CLIENT_SECRET.
Is Whoop maintained?
The last commit was 114 days ago (2026-07-13). The latest release is v0.8.5.
What can I use instead of Whoop?
Servers from other publishers that do the same job: Clude MCP server, DBHub MCP server and Mindwtr MCP server.
How does Whoop compare with other Databases MCP servers?
safety score 78/100 (higher than 47% of 802 Databases servers); tools 17 (the typical Databases server has 8); tools that change things 6% (typical: 10%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Whoop

Same job from other publishers: the closest match first, then the best rated.

  • Clude
    Portable agent memory anchored on Solana. Local SQLite + vector recall, open export.
    B
  • DBHub
    Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite
    A
  • Mindwtr
    Task automation via SQLite, desktop Local API, or Mindwtr Cloud; read-only by default.
    A
  • Sequential Thinking Working Notes
    Local working notes, decisions, evidence and resumable sessions with SQLite persistence.
    A
  • Faucet
    SQL database to MCP tools and REST API: PostgreSQL, MySQL, SQL Server, Oracle, SQLite, Snowflake.
    A