> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# WHOOP

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Show me my recovery score trend over the last 7 days.
* Pull last night's sleep performance and compare to my baseline.
* Find workouts in the last 30 days where strain exceeded 18.

## Available Tools

#### list_cycles

List WHOOP physiological cycles with cursor pagination. Use next_token from response for subsequent pages. Filter by ...

#### get_cycle

Get a specific WHOOP physiological cycle by ID. Use list_cycles to find valid cycle IDs.

#### get_sleep_for_cycle

Get sleep activity linked to a specific WHOOP cycle. Returns the sleep record associated with the given cycle ID. Use...

#### list_recoveries

List WHOOP recovery records with cursor pagination. Includes recovery score, HRV, resting heart rate, and SpO2. Filte...

#### list_sleep_activities

List WHOOP sleep activities with cursor pagination. Use next_token from response for subsequent pages. Filter by star...

#### get_sleep_activity

Get a specific WHOOP sleep activity by ID, including stage breakdown, respiratory rate, and performance scores. Use l...

#### get_user_profile

Get the current user's WHOOP profile including first name, last name, email, and user ID.

#### get_body_measurements

Get the current user's WHOOP body measurements including height (meters), weight (kg), and max heart rate.

#### list_workouts

List WHOOP workout activities with cursor pagination. Use next_token from response for subsequent pages. Filter by st...

#### get_workout

Get a specific WHOOP workout by ID, including strain score, heart rate zones, distance, and kilojoules. Use list_work...