WHOOP MCP Server

Erholung, Schlaf, Belastung und Workouts von deinem WHOOP, von deinem Agenten ausgelesen.

Gehosteter MCP-Server

npx add-mcp 'https://cotlet.dev/mcp/v1/whoop'

Installiert in Claude Code, Codex, Cursor und mehr

Dokumentation

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

WHOOP API and MCP server: Let your AI agent read your WHOOP data.

WHOOP has an official developer API (v2, OAuth 2.0, read-only) but no official MCP server (checked 27 Oct 2026). Cotlet runs 8 WHOOP tools hosted, over MCP for agents and REST for scripts, in your own login.

Read your WHOOP daily strain, recovery and sleep records through MCP or REST. Connect an AI agent or create a private reporting workflow with HTTP requests.

MCP setup REST API guide

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by WHOOP. WHOOP is a trademark of its owner. If WHOOP's own integrations cover what you need, use them first.

What can you automate in WHOOP?

  • Brief you on today's recovery
  • Review a week of sleep stages
  • Compare strain with recovery
  • List and rank your workouts
  • Run a briefing every morning
  • Check your membership plan

Does WHOOP have an MCP server or an API?

  • The API returns profile, body measurements, cycles, recovery, sleep and workouts, and sends webhooks for recovery, sleep and workout changes. Its only write removes an app's access.
  • Using it means a developer team, an app, a redirect URL and an OAuth flow. An app WHOOP has not approved serves 10 members, and each step up is a manual review.
  • Zapier and n8n list no WHOOP app, and its limits are 100 requests a minute and 10,000 a day.
What you needWHOOP APIGitHub MCP serverCotlet
Recovery, sleep, strain, workoutsYes, in your own codeYesYes
Works from Claude or ChatGPTNo MCP serverDesktop apps; web needs hostingYes, hosted
No developer app or OAuth setupApp and OAuth neededYour own appYes
Membership planNo endpointNoYes

Checked 27 Oct 2026. Sources: WHOOP API docs, WHOOP Developer Platform: Getting Started, WHOOP Developer Platform: App Approval, WHOOP API rate limiting

How does Cotlet connect to WHOOP?

  1. Sign in to WHOOP. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

We never keep your WHOOP password, and every WHOOP tool only reads.

Connect WHOOP to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Enable WHOOP for agents. Sign up, log in to WHOOP in its Cloud Browser, then press Enable for agents.
  2. Paste the Cotlet address. Add https://cotlet.dev/mcp/v1 as an MCP server or connector in your agent.
  3. Approve the connection. Chat apps ask you to sign in to Cotlet. Editors, n8n and scripts use an API key from the console.

One shared address, https://cotlet.dev/mcp/v1, also carries WHOOP next to your other apps. If you enable WHOOP after connecting, refresh the connector so the new tools show up.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet-whoop \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet-whoop": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet-whoop]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: whoop_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: whoop_read

How to use the WHOOP REST API

Create your Cotlet API key

Create a Cotlet API key with access to WHOOP and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Sign in to WHOOP in its Cotlet Cloud Browser and enable the app for agents. Use the WHOOP membership account that owns your band.

Make your first WHOOP API request

REST:

curl "https://cotlet.dev/api/v1/whoop/day-summary?date=2026-10-26" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read dated records and retain their units

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "whoop",
  "tool": "get_day_summary",
  "result": {
    "date": "2026-10-26",
    "strain": 12.4,
    "recovery_percent": 68,
    "sleep_performance_percent": 91,
    "hours_of_sleep": 7.4,
    "sleep_needed_hours": 8.1
  }
}

This request reads a named day; replace the date with the day you want. Read percentages as percentages and the sleep-duration fields as hours.

Daily summary has no pagination; the web view exposes six months of records. Today's strain remains partial until the day ends.

Recovery, sleep, workout and cycle lists use cursors, with 10 records by default and at most 25. Keep date filters fixed while paging; sleep-stage durations use minutes and HRV uses milliseconds.

WHOOP workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestRead daily strain, recovery and sleep values into your private journal without changing recorded data.
MakeHTTP > Make a requestCombine sleep lists and sleep details into a factual duration and stage report that retains minutes and hours.
Python or Node.jsREST APIRead workout details into a personal strain and duration journal without generating training or medical advice.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads WHOOP; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

WHOOP API endpoints and MCP tools

Recovery and day strain

Recovery score, HRV, resting heart rate and day strain. The current day is still open, so its strain grows until the day ends.

  • Get day summary (get_day_summary, read): One day's Strain, Recovery and Sleep Performance as the WHOOP web app shows them.
  • List recoveries (list_recoveries, read): Daily recovery with score, heart rate variability and resting heart rate.
  • List cycles (list_cycles, read): Physiological days with day strain and average heart rate.

Sleep

Sleep Performance and minutes in each stage. get_sleep takes the sleep_id from list_sleeps.

  • List sleeps (list_sleeps, read): Sleeps with performance percent and time in each stage.
  • Get sleep (get_sleep, read): One sleep with its stages and Sleep Performance.

Workouts

Sport, duration, strain and average heart rate. list_workouts can keep one sport.

  • List workouts (list_workouts, read): Workouts with sport, strain and average heart rate.
  • Get workout (get_workout, read): One workout with strain, duration and heart rate.

Membership

Your plan and renewal date. Changing or cancelling it is not a tool.

  • Get membership (get_membership, read): Your WHOOP plan and renewal date from the Membership page.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/whoop-api-mcp-server#tools

Who can see my WHOOP session, and how do I revoke it?

  • What we store. Your logged-in WHOOP profile, encrypted with AES-256-GCM, in Finland. Not the password.
  • What your agent gets. The 8 WHOOP tools. Never the cookie.
  • What the session sees. Your own account: recovery, sleep, strain, workouts and membership.
  • What no tool touches. Plan changes, cancelling, payment details, password and deleting data.
  • If WHOOP asks to verify. A new device can ask for a code. You type it in, we never do.
  • How to cut access. Disable for agents, reset the browser, or sign out of WHOOP.

Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Safety and mistakes

  1. Reads your day. Recovery, sleep and strain for the dates you ask about.
  2. Checks the window. The web app shows 6 months, so older dates come back empty.
  3. Marks an open day. Today's strain is partial until the day ends.
  4. Reports what it found. Numbers as WHOOP shows them, with the dates.
CaseWhat happens
The agent asks for data before 6 months agoThe call returns an empty list; the agent says the window is 6 months
You ask to change your planThere is no tool for it; do it in WHOOP
The agent reads the wrong dayNothing changed, so ask again with the date

All 8 tools read, so none waits for your OK and nothing can edit, delete or send. Scheduled runs need no approval.

WHOOP data is health data. Share the agent's answers only with people you trust.

MCP call:

{
  "name": "list_recoveries",
  "arguments": {
    "from": "2026-10-24",
    "to": "2026-10-26"
  }
}

REST:

curl "https://cotlet.dev/api/v1/whoop/recoveries?from=2026-10-24&to=2026-10-26" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Tool output:

{
  "recoveries": [
    {
      "date": "2026-10-26",
      "recovery_percent": 68,
      "hrv_ms": 74,
      "resting_heart_rate": 52
    },
    {
      "date": "2026-10-25",
      "recovery_percent": 81,
      "hrv_ms": 88,
      "resting_heart_rate": 50
    },
    {
      "date": "2026-10-24",
      "recovery_percent": 43,
      "hrv_ms": 61,
      "resting_heart_rate": 57
    }
  ],
  "next_cursor": null
}

Scripts and cron jobs reach the same tools over REST at /api/v1/whoop, with the same key and price. A failed call costs nothing. The tools table lists the REST path of each tool.

How much does the WHOOP MCP server cost?

About $13 a month for a daily morning briefing and a weekly review, 2,270 credits. Your WHOOP membership is billed by WHOOP as before.

JobCallsCredits
Morning recovery briefing, daily2 × 30600
Weekly sleep and strain review4 × 4160
Membership check1 × 110
Cloud Browser, 30 days1,500
Total2,270
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Works on every WHOOP membership you can log in with

The month is our example: a two-call briefing every morning and a four-call review on four Sundays. No public figure for how often a member asks exists. Dollars at the $29 pack rate.

WHOOP MCP server on GitHub, hosted or the API: which to use

OptionWhat it doesWhere it stops
shashankswe2020-ux/whoop-mcp16 read-only tools on the official API, 175 stars, last push 25 Oct 2026.Runs on your computer with your own developer app. Claude web, phone and ChatGPT need you to host it.
yuridivonis/whoop-mcp-serverRemote MCP for a Claude.ai custom connector on API v2, 16 stars, last push 21 Oct 2026.You host it and register the WHOOP app.
briangaoo/whoop-mcp55 tools with writes, 136 stars, through WHOOP's private iOS API.Needs your WHOOP password.
Older servers (nissand, RomanEvstigneev, JedPattersonn)Claude Desktop servers with 13 to 27 stars.No push since Jul to Oct 2025.
Hosted WHOOP connectorsSeveral services run the official API for you, free or from about $39 a year, per their own pages.WHOOP serves 10 members on an unapproved app, so a shared app has a member cap.
Zapier and n8nNeither lists a WHOOP app (checked 27 Oct 2026).You build the API calls with a generic OAuth step.

If you are happy to register a developer app and run a server, a GitHub server on the official API is free. Cotlet is for people who want the same reading in Claude or ChatGPT with no app to register and no server to fix.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), working since 2019, founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the WHOOP tools.

WHOOP API and MCP: questions

Can I use the WHOOP API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.

How do I get access?

Create a free account at https://cotlet.dev, open WHOOP under Integrations in the console and log in to WHOOP in its Cloud Browser. The trial starts when you sign up, no card asked.

How do I connect WHOOP to ChatGPT or Claude?

Sign up at cotlet.dev, log in to WHOOP once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your WHOOP account through Cotlet, in their phone apps too.

What can ChatGPT do in WHOOP?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in WHOOP: morning recovery briefing; weekly sleep and strain review; compare workouts with recovery. You ask in plain words, and anything that reaches other people waits for your OK first.

How far back does the data go?

The WHOOP web app shows 6 months of data (WHOOP Basics, checked 27 Oct 2026), and the tools read what the web app shows. Steps are not in the web app, so no tool returns them. The official API added a step count to cycles on 23 Sep 2026.

Does WHOOP send webhooks?

Yes, through the official API: recovery, sleep and workout updated and deleted events (checked 27 Oct 2026). A Cotlet agent does not receive them. Run it on a schedule instead, for example a morning list_recoveries call.

Is the data the same as in the official API?

The figures come from what the WHOOP web app shows, not from the API. Strain, Recovery and Sleep Performance are the same scores WHOOP computes. The API has fields the web app lacks, for example steps, which the web app does not show.

Can the agent log a workout or edit my journal?

No. All tools read. The official API is read-only as well, apart from revoking an app's access.

Is the MCP server different from the REST API?

Only the door is different. Both expose the same 8 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with WHOOP?

No. Cotlet is independent and not affiliated with WHOOP, Inc.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.