连接器指南阅读约 3 分钟11 个 MCP 工具7 种语言

WHOOP 接入 MCP:在任意 AI 智能体中查看恢复、HRV、睡眠、负荷和训练数据

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

WHOOP

WHOOP

Read a WHOOP member's recovery, HRV, resting heart rate, sleep and naps with stages, day strain per cycle, workouts with heart rate zones, profile and body measurements through the WHOOP Developer API v2 with OAuth. Read-only.

个工具

11

区域

INTL

类别

体育

身份验证

OAuth 2.0

所需环境变量

WHOOP_CLIENT_IDWHOOP_CLIENT_SECRET
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 WHOOP,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。

试试这样问

WHOOP 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

WHOOP · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → WHOOP、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无 git clone、无本地服务器。

WHOOP

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。

设置

设置大约需要 10 分钟,只需做一次。你需要一个 WHOOP 账户。

  1. 打开 WHOOP Developer Dashboard(https://developer-dashboard.whoop.com),用 WHOOP 账户登录。按提示创建一个团队(一个团队最多可容纳 5 个应用)。
  2. 点击 Create App。在 Scopes 下勾选 read:profile、read:body_measurement、read:cycles、read:recovery、read:sleep 和 read:workout。连接器还会请求 offline,WHOOP 需要它才能签发刷新令牌。
  3. 在 Redirect URIs 下添加回调地址:AnythingMCP Cloud 上为 https://cloud.anythingmcp.com/api/mcp-oauth/callback,自行托管 AnythingMCP 时为 <your AnythingMCP URL>/api/mcp-oauth/callback。
  4. 保存,并把 Client ID 和 Client Secret 复制到 WHOOP_CLIENT_ID 和 WHOOP_CLIENT_SECRET。安装连接器,点击 Authorize with Provider,并用 AI 需要读取其数据的 WHOOP 账户允许访问。
  5. 运行 whoop_get_profile 检查连接。

访问令牌有效期约一小时,会自动续期;WHOOP 在每次续期时都会更换刷新令牌。

可读取的内容:已连接会员的个人资料和身体数据(身高、体重、最大心率);生理周期,一个周期就是一个 WHOOP 日,从醒来到下一次醒来,包括日负荷、能量消耗和心率;每个周期的恢复情况,包括恢复分数、HRV、静息心率,以及 WHOOP 4.0 或更新设备上的 SpO2 和皮肤温度;睡眠和小睡,包括各睡眠阶段的时长、睡眠需求、睡眠表现、一致性、效率和呼吸频率;以及训练,包括运动项目、负荷、心率、能量消耗、距离、海拔和在各心率区间的时长。

查找某一天:AI 列出周期(最新的周期在进行中时没有 end),并从周期 ID 找到对应的恢复和睡眠。分析趋势时,它会列出某个 start 和 end 之间的恢复、睡眠或训练记录。

只读:所有工具都只读。WHOOP API 不提供任何写入数据的方式,因此没有需要确认的操作,安装时也没有被关闭的工具。日志条目、压力监测、心率数据流和 WHOOP Coach 不属于公开 API。

格式:只有 score_state 为 SCORED 的记录才带有分数;PENDING_SCORE 表示 WHOOP 仍在计算,UNSCORABLE 表示永远不会有分数(例如没有佩戴手环时)。时间为 UTC,timezone_offset 是会员所在地的时差,AI 会先应用它再确定当地日期。以 _milli 结尾的时长单位为毫秒。负荷采用 WHOOP 的 0 到 21 分制,kilojoule 表示能量(除以 4.184 得到千卡),百分比为 0 到 100,心率单位为每分钟心跳次数。

限制:列表工具每次调用最多返回 25 条记录,最新的在前,还有更多记录时会返回 next_token。WHOOP 默认允许每个应用每分钟 100 次、每天 10,000 次请求;超出后返回 429。

常见错误:401 表示授权已过期或被撤销(请再次点击 Authorize with Provider),某类数据返回 403 或空结果通常表示未授予相应的权限范围,404 表示 ID 未知。

前提条件: WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET

本地安装连接器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

打开 http://localhost:3000/connectors/store,选择 WHOOP 并填入前提条件中列出的环境变量。

可用工具

ToolWhat it does
whoop_get_profileThe signed-in WHOOP member: user_id, email, first and last name
whoop_get_body_measurementThe member's body measurements as stored in WHOOP: height_meter, weight_kilogram and the max_heart_rate WHOOP calculated
whoop_list_cyclesPhysiological cycles (one WHOOP day, from waking to waking), newest first: id, start, end (missing for the current cycle), timezone_offset…
whoop_get_cycleOne physiological cycle by id: start, end, score_state and score (strain, kilojoule, average and max heart rate)
whoop_get_cycle_sleepThe main sleep that belongs to a cycle (the sleep before that WHOOP day), with stages, sleep need, performance, consistency and efficiency
whoop_get_cycle_recoveryThe recovery of a cycle: recovery_score (0 to 100 %), resting_heart_rate, hrv_rmssd_milli, and on WHOOP 4.0 or newer spo2_percentage and…
whoop_list_recoveriesRecoveries, newest first (by the start of their cycle): cycle_id, sleep_id, score_state and score with recovery_score (0 to 100 %)…
whoop_list_sleepsSleeps and naps, newest first: id (UUID), cycle_id, start, end, nap, score_state and score with time in bed and per stage (light, slow…
whoop_get_sleepOne sleep or nap by its UUID, with the full score (stage summary, sleep need, performance, consistency, efficiency, respiratory rate)
whoop_list_workoutsWorkouts, newest first: id (UUID), sport_name, start, end, score_state and score with strain, average and max heart rate, kilojoule…
whoop_get_workoutOne workout by its UUID: sport, times, strain, heart rate, kilojoule, distance, altitude and heart rate zone durations

示例提示

  • “我今天的恢复分数是多少?我的 HRV 和静息心率与 30 天平均值相比如何?”
  • “这周我每晚睡了多久?其中有多少是 REM 睡眠和慢波睡眠?”
  • “列出我过去两周的训练,包括运动项目、负荷以及在心率区间 4 和 5 的时长。”
  • “在日负荷超过 15 之后的那些早上,我的恢复情况怎么样?”
  • “这个月我有没有小睡?每次多久?”

下一步

这份指南对你有帮助吗?

你的 WHOOP 智能体只差一次点击。

安装连接器,粘贴密钥,向你的 AI 客户端提问。免费试用 7 天,无需信用卡。

相关指南

连接器

如何通过 MCP 将 WHOOP 连接到 ChatGPT

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。

连接器

如何通过 MCP 将 WHOOP 连接到 Claude

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。

连接器

如何通过 MCP 将 WHOOP 连接到 Microsoft Copilot

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。

连接器

如何通过 MCP 将 WHOOP 连接到 Cursor

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。

连接器

如何通过 MCP 将 WHOOP 连接到 Gemini

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。

连接器

如何通过 MCP 将 WHOOP 连接到 Meta Muse

通过 WHOOP Developer API v2 和 OAuth 读取 WHOOP 会员的恢复、HRV、静息心率、睡眠和小睡(含睡眠阶段)、每个周期的日负荷、带心率区间的训练、个人资料和身体数据。只读。