WHOOP MCP by usefulapi

Working · 600 ms

io.usefulapi/whoopv1.21.0 Domain verified

Read WHOOP recovery, sleep, cycles, workouts and body measurements.

Health & Science

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://whoop.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

whoop_body_measurement Read-only

The user's body measurements (height in meters, weight in kilograms, max heart rate). WHOOP REST: GET /v2/user/measurement/body. Scope: read:body_measurement.

This tool takes no arguments.

Tools (10)

whoop_body_measurement

The user's body measurements (height in meters, weight in kilograms, max heart rate). WHOOP REST: GET /v2/user/measurement/body. Scope: read:body_measurement.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

whoop_get_cycle

Get a single physiological cycle by its id (strain, kilojoules, average/max heart rate, start/end). WHOOP REST: GET /v2/cycle/{cycleId}. Scope: read:cycles.

read-only

Argument	Type	Description
cycleId*	string	The cycle id (an integer, e.g. from whoop_list_cycles).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cycleId"
  ],
  "properties": {
    "cycleId": {
      "type": "string",
      "minLength": 1,
      "description": "The cycle id (an integer, e.g. from whoop_list_cycles)."
    }
  }
}

whoop_get_cycle_recovery

Get the recovery scored for a specific cycle (recovery %, resting heart rate, HRV RMSSD, SpO2 %, skin temperature). WHOOP REST: GET /v2/cycle/{cycleId}/recovery. Scope: read:recovery.

read-only

Argument	Type	Description
cycleId*	string	The cycle id (an integer, e.g. from whoop_list_cycles).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cycleId"
  ],
  "properties": {
    "cycleId": {
      "type": "string",
      "minLength": 1,
      "description": "The cycle id (an integer, e.g. from whoop_list_cycles)."
    }
  }
}

whoop_get_profile

The current user's basic WHOOP profile (user id, email, first name, last name). WHOOP REST: GET /v2/user/profile/basic. Scope: read:profile.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

whoop_get_sleep

Get a single sleep activity by its id (stage summary, sleep needed, respiratory rate, sleep performance %, start/end). WHOOP REST: GET /v2/activity/sleep/{sleepId}. Scope: read:sleep.

read-only

Argument	Type	Description
sleepId*	string	The sleep id (a UUID, e.g. from whoop_list_sleep).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sleepId"
  ],
  "properties": {
    "sleepId": {
      "type": "string",
      "minLength": 1,
      "description": "The sleep id (a UUID, e.g. from whoop_list_sleep)."
    }
  }
}

whoop_get_workout

Get a single workout by its id (sport, strain, average/max heart rate, distance, zone durations, start/end). WHOOP REST: GET /v2/activity/workout/{workoutId}. Scope: read:workout.

read-only

Argument	Type	Description
workoutId*	string	The workout id (a UUID, e.g. from whoop_list_workouts).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "workoutId"
  ],
  "properties": {
    "workoutId": {
      "type": "string",
      "minLength": 1,
      "description": "The workout id (a UUID, e.g. from whoop_list_workouts)."
    }
  }
}

whoop_list_cycles

List the user's physiological cycles (a WHOOP 'day', ~24h anchored to sleep), most recent first. Each cycle carries a score with day strain, kilojoules burned, and average/max heart rate. Paginated (limit/nextToken) and filterable by created-time window (start/end). WHOOP REST: GET /v2/cycle. Scope: read:cycles.

read-only

Argument	Type	Description
end	string	Return records created before this ISO 8601 datetime, e.g. 2024-02-01T00:00:00.000Z.
limit	integer	Max records to return per page (1–25, default 10).
start	string	Return records created at/after this ISO 8601 datetime, e.g. 2024-01-01T00:00:00.000Z.
nextToken	string	Pagination cursor: pass the `next_token` from a previous response to fetch the next page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "end": {
      "type": "string",
      "description": "Return records created before this ISO 8601 datetime, e.g. 2024-02-01T00:00:00.000Z."
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Max records to return per page (1–25, default 10)."
    },
    "start": {
      "type": "string",
      "description": "Return records created at/after this ISO 8601 datetime, e.g. 2024-01-01T00:00:00.000Z."
    },
    "nextToken": {
      "type": "string",
      "description": "Pagination cursor: pass the `next_token` from a previous response to fetch the next page."
    }
  }
}

whoop_list_recoveries

List the user's recoveries, most recent first. Each recovery scores how ready the body is (recovery %, resting heart rate, HRV RMSSD, SpO2 %, skin temperature) and links to its cycle and sleep. Paginated (limit/nextToken) and filterable by created-time window (start/end). WHOOP REST: GET /v2/recovery. Scope: read:recovery.

read-only

Argument	Type	Description
end	string	Return records created before this ISO 8601 datetime, e.g. 2024-02-01T00:00:00.000Z.
limit	integer	Max records to return per page (1–25, default 10).
start	string	Return records created at/after this ISO 8601 datetime, e.g. 2024-01-01T00:00:00.000Z.
nextToken	string	Pagination cursor: pass the `next_token` from a previous response to fetch the next page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "end": {
      "type": "string",
      "description": "Return records created before this ISO 8601 datetime, e.g. 2024-02-01T00:00:00.000Z."
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Max records to return per page (1–25, default 10)."
    },
    "start": {
      "type": "string",
      "description": "Return records created at/after this ISO 8601 datetime, e.g. 2024-01-01T00:00:00.000Z."
    },
    "nextToken": {
      "type": "string",
      "description": "Pagination cursor: pass the `next_token` from a previous response to fetch the next page."
    }
  }
}

whoop_list_sleep

List the user's sleep activities, most recent first. Each carries a score with sleep-stage summary, sleep needed, respiratory rate, and sleep performance %. Paginated (limit/nextToken) and filterable by created-time window (start/end). WHOOP REST: GET /v2/activity/sleep. Scope: read:sleep.

read-only

Argument	Type	Description
end	string	Return records created before this ISO 8601 datetime, e.g. 2024-02-01T00:00:00.000Z.
limit	integer	Max records to return per page (1–25, default 10).
start	string	Return records created at/after this ISO 8601 datetime, e.g. 2024-01-01T00:00:00.000Z.
nextToken	string	Pagination cursor: pass the `next_token` from a previous response to fetch the next page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "end": {
      "type": "string",
      "description": "Return records created before this ISO 8601 datetime, e.g. 2024-02-01T00:00:00.000Z."
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Max records to return per page (1–25, default 10)."
    },
    "start": {
      "type": "string",
      "description": "Return records created at/after this ISO 8601 datetime, e.g. 2024-01-01T00:00:00.000Z."
    },
    "nextToken": {
      "type": "string",
      "description": "Pagination cursor: pass the `next_token` from a previous response to fetch the next page."
    }
  }
}

whoop_list_workouts

List the user's workouts, most recent first. Each carries a score with strain, average/max heart rate, distance (meters), and per-heart-rate-zone durations. Paginated (limit/nextToken) and filterable by created-time window (start/end). WHOOP REST: GET /v2/activity/workout. Scope: read:workout.

read-only

Argument	Type	Description
end	string	Return records created before this ISO 8601 datetime, e.g. 2024-02-01T00:00:00.000Z.
limit	integer	Max records to return per page (1–25, default 10).
start	string	Return records created at/after this ISO 8601 datetime, e.g. 2024-01-01T00:00:00.000Z.
nextToken	string	Pagination cursor: pass the `next_token` from a previous response to fetch the next page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "end": {
      "type": "string",
      "description": "Return records created before this ISO 8601 datetime, e.g. 2024-02-01T00:00:00.000Z."
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Max records to return per page (1–25, default 10)."
    },
    "start": {
      "type": "string",
      "description": "Return records created at/after this ISO 8601 datetime, e.g. 2024-01-01T00:00:00.000Z."
    },
    "nextToken": {
      "type": "string",
      "description": "Pagination cursor: pass the `next_token` from a previous response to fetch the next page."
    }
  }
}