WHOOP MCP: данные браслета в Claude Code, Codex и Cursor

shashankswe2020-ux/whoop-mcp· Проверено 12.11.2026· 181на GitHub

Отдаёт агенту ваши данные WHOOP только на чтение: восстановление, HRV, сон, нагрузку и тренировки. Агент сравнит недели, найдёт недосып и соберёт недельный обзор.

3 реализации:

Локальный сервер: 16 инструментов на чтение, базовые уровни и долг сна, плюс 9 инструментов для HYROX и триатлона с локальной панелью графиков.

Как подключить

Что сделать до подключения

Node.js 20 или новее

Активное членство WHOOP

Приложение разработчика на developer.whoop.com с адресом возврата http://localhost:3000/callback

Мастер настройки: npx -y whoop-ai-mcp@latest setup --client=claude-code (или codex, cursor, vscode, claude-desktop)

WHOOP_CLIENT_ID

developer.whoop.com → новое приложение → Redirect URI http://localhost:3000/callback, области read:profile, read:recovery, read:sleep, read:workout, read:cycles, read:body_measurement → скопировать Client ID

WHOOP_CLIENT_SECRET

там же, Client Secret приложения

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'WHOOP_CLIENT_ID=<Client ID приложения WHOOP>' --env 'WHOOP_CLIENT_SECRET=<Client Secret приложения WHOOP>' --transport stdio whoop \
  -- npx -y whoop-ai-mcp@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.whoop]
command = "npx"
args = ["-y", "whoop-ai-mcp@latest"]

[mcp_servers.whoop.env]
WHOOP_CLIENT_ID = "<Client ID приложения WHOOP>"
WHOOP_CLIENT_SECRET = "<Client Secret приложения WHOOP>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "whoop-ai-mcp@latest"],
      "env": {
        "WHOOP_CLIENT_ID": "<Client ID приложения WHOOP>",
        "WHOOP_CLIENT_SECRET": "<Client Secret приложения WHOOP>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "whoop": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "whoop-ai-mcp@latest"],
      "env": {
        "WHOOP_CLIENT_ID": "<Client ID приложения WHOOP>",
        "WHOOP_CLIENT_SECRET": "<Client Secret приложения WHOOP>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "whoop-ai-mcp@latest"],
      "env": {
        "WHOOP_CLIENT_ID": "<Client ID приложения WHOOP>",
        "WHOOP_CLIENT_SECRET": "<Client Secret приложения WHOOP>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "whoop-ai-mcp@latest"],
      "env": {
        "WHOOP_CLIENT_ID": "<Client ID приложения WHOOP>",
        "WHOOP_CLIENT_SECRET": "<Client Secret приложения WHOOP>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "whoop": {
        "type": "local",
        "command": ["npx", "-y", "whoop-ai-mcp@latest"],
        "environment": {
          "WHOOP_CLIENT_ID": "<Client ID приложения WHOOP>",
          "WHOOP_CLIENT_SECRET": "<Client Secret приложения WHOOP>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "whoop-ai-mcp@latest"],
      "env": {
        "WHOOP_CLIENT_ID": "<Client ID приложения WHOOP>",
        "WHOOP_CLIENT_SECRET": "<Client Secret приложения WHOOP>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "whoop-ai-mcp@latest"],
      "env": {
        "WHOOP_CLIENT_ID": "<Client ID приложения WHOOP>",
        "WHOOP_CLIENT_SECRET": "<Client Secret приложения WHOOP>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_todayсводка дня: восстановление, сон, нагрузка

get_baselinesсчитает ваши личные базовые уровни

get_sleep_debtсчитает долг сна

get_weekly_summaryсобирает недельный обзор

get_trendищет тренд и выбросы показателя

compare_periodsсравнивает два периода

get_calendarсетка восстановления и сна по дням

get_recovery_collectionвыгружает записи восстановления

get_sleep_collectionвыгружает записи сна

get_workout_collectionвыгружает тренировки

get_cycle_collectionвыгружает циклы нагрузки

get_profileчитает профиль

get_body_measurementчитает рост, вес и пульс

get_hyrox_session_reportразбирает тренировку HYROX по отрезкам

get_triathlon_performanceсчитает баланс плавания, вела и бега

get_race_readinessоценивает готовность к старту

verify_claimпересчитывает число из ответа агента

open_performance_dashboardоткрывает локальную панель графиков

Показано 18 из 25.

Удалённый сервер, который вы разворачиваете сами на Railway или в Docker: подключается к Claude.ai и ChatGPT как коннектор, вход по паролю через OAuth 2.1.

Как подключить

Что сделать до подключения

Развернуть образ ghcr.io/yuridivonis/whoop-mcp-server:1 на Railway или через docker run, с томом /data

Задать переменные MCP_AUTH_PASSWORD (не короче 16 знаков), WHOOP_CLIENT_ID и WHOOP_CLIENT_SECRET

Приложение разработчика в Whoop Developer Dashboard с адресом возврата https://<адрес вашего сервера>/callback

Публичный https-адрес: на своём компьютере нужен туннель на порт 3000

MCP_AUTH_PASSWORD

придумайте сами, например openssl rand -base64 24; его спросит каждое подключаемое приложение

WHOOP_CLIENT_ID и WHOOP_CLIENT_SECRET

Whoop Developer Dashboard → New App, области read:recovery, read:cycles, read:sleep, read:workout → Create App

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http whoop-mcp-server https://<адрес вашего сервера>/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.whoop-mcp-server]
url = "https://<адрес вашего сервера>/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "whoop-mcp-server": {
      "url": "https://<адрес вашего сервера>/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "whoop-mcp-server": {
      "type": "http",
      "url": "https://<адрес вашего сервера>/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "whoop-mcp-server": {
      "httpUrl": "https://<адрес вашего сервера>/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "whoop-mcp-server": {
      "httpUrl": "https://<адрес вашего сервера>/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "whoop-mcp-server": {
        "type": "remote",
        "url": "https://<адрес вашего сервера>/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://<адрес вашего сервера>/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "whoop-mcp-server": {
      "url": "https://<адрес вашего сервера>/mcp"
    }
  }
}

Инструменты сервера

get_todayутренняя сводка за сегодня

get_recovery_trendsпоказывает восстановление, HRV и пульс покоя

get_sleep_analysisразбирает сон по ночам

get_strain_historyпоказывает нагрузку, калории и шаги

get_workoutsвыгружает тренировки с пульсовыми зонами

get_auth_urlвыдаёт ссылку для входа в WHOOP

Локальный сервер с демо на синтетических данных без входа, тремя режимами приватности и готовыми промптами тренера.

Как подключить

Что сделать до подключения

Node.js 20 или новее

Приложение разработчика WHOOP с адресом возврата http://127.0.0.1:3000/callback

Выполнить npx -y whoop-mcp-unofficial setup, затем auth и doctor

WHOOP_CLIENT_ID и WHOOP_CLIENT_SECRET

developer.whoop.com → новое приложение; команда setup спросит оба значения и сохранит их в ~/.whoop-mcp/config.json

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio whoop-mcp \
  -- npx -y whoop-mcp-unofficial

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.whoop-mcp]
command = "npx"
args = ["-y", "whoop-mcp-unofficial"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": ["-y", "whoop-mcp-unofficial"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "whoop-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "whoop-mcp-unofficial"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": ["-y", "whoop-mcp-unofficial"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": ["-y", "whoop-mcp-unofficial"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "whoop-mcp": {
        "type": "local",
        "command": ["npx", "-y", "whoop-mcp-unofficial"]
      }
    }
  }
}

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": ["-y", "whoop-mcp-unofficial"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "whoop-mcp": {
      "command": "npx",
      "args": ["-y", "whoop-mcp-unofficial"]
    }
  }
}

Инструменты сервера

whoop_demoотдаёт синтетические данные без входа

whoop_connection_statusпроверяет настройку

whoop_daily_summaryсводка готовности на сегодня

whoop_weekly_summaryнедельный итог и план

whoop_list_recoveriesвыгружает записи восстановления

whoop_list_sleepsвыгружает записи сна

whoop_list_cyclesвыгружает циклы нагрузки

whoop_list_workoutsвыгружает тренировки

whoop_get_profileчитает профиль

whoop_get_body_measurementsчитает рост, вес и пульс

whoop_privacy_auditпроверяет настройки приватности

whoop_revoke_accessудаляет токены и отзывает доступ

Что попросить агента

«Как я сегодня?»Агент вызовет get_today, get_baselines и get_sleep_debt

«Мой HRV необычный для меня?»Агент вызовет get_baselines: распределение, перцентили и число дней в расчёте

«Как изменился мой сон за этот месяц?»Агент вызовет get_trend и compare_periods, посчитает долг сна через get_sleep_debt

«Собери мой недельный обзор здоровья»Агент вызовет get_weekly_summary или whoop_weekly_summary

«Как прошла вчерашняя тренировка HYROX и готов ли я к триатлону через две недели?»Агент вызовет get_hyrox_session_report и get_race_readiness

Для каких задач

Ответить, как вы сегодня: восстановление, сон, нагрузка и последняя тренировка

Проверить, необычен ли ваш HRV по сравнению с вашим же базовым уровнем

Сравнить сон этого месяца с прошлым и посчитать долг сна

Собрать недельный обзор восстановления, сна и тренировок

Разобрать тренировку HYROX по отрезкам и оценить готовность к триатлону

Ограничения

Нужны активное членство WHOOP и своё приложение разработчика: Client ID и Client Secret выдаёт developer.whoop.com

Записывать в аккаунт WHOOP серверы не умеют, непрерывный пульс и сырые данные датчиков публичный API не отдаёт

Данные о здоровье уходят провайдеру ИИ, с которым вы общаетесь; режим aggregate в whoop-ai-mcp оставляет 5 сводных инструментов, но анонимизацией не считается

Whoop MCP Server и whoop-mcp-unofficial — небольшие проекты: 18 и 15 звёзд на GitHub

Если не работает

Сервер пишет Missing required environment variable: WHOOP_CLIENT_ID

Ключи приложения не заданы. Добавьте WHOOP_CLIENT_ID и WHOOP_CLIENT_SECRET в env сервера в конфиге клиента.

Ошибка Network error: Unable to reach the WHOOP API

Проверьте связь: адрес https://api.prod.whoop.com должен открываться с вашего компьютера.

WHOOP API returned 401

Токен истёк или отозван. Остановите сервер, переименуйте ~/.whoop-mcp/tokens.json в резервную копию и запустите снова: WHOOP попросит войти заново.

При первом входе браузер не открылся

Найдите в выводе терминала адрес авторизации и откройте его вручную. Адрес возврата в приложении WHOOP должен совпадать до символа.

Инструменты не появились в клиенте

Полностью закройте и откройте клиент. Проверьте, что процессу клиента доступны Node и npm, при нужде пропишите полный путь к npx; в режиме aggregate часть инструментов скрыта намеренно.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
whoop-ai-mcp	shashankswe2020-ux	181	локально	вход	25	10 ноября 2026
Whoop MCP Server	yuridivonis	18	HTTP	вход	6	4 ноября 2026
WHOOP MCP (whoop-mcp-unofficial)	davidmosiah	15	локально	вход	12	5 ноября 2026

Частые вопросы

Нужен ли аккаунт разработчика WHOOP?

Да, во всех трёх вариантах. Создайте приложение на developer.whoop.com, укажите адрес возврата и области чтения, скопируйте Client ID и Client Secret. Членство WHOOP и доступ к API в пакет не входят.

Есть ли готовый облачный сервер, чтобы не ставить ничего у себя?

Готового хостинга у этих проектов нет. whoop-ai-mcp работает на вашем компьютере без посредника, для Claude.ai и ChatGPT его нужно развернуть самим. Whoop MCP Server разворачивается в один клик на Railway, на тарифе Hobby.

Может ли агент что-то изменить в моём WHOOP?

Нет: в whoop-ai-mcp нет инструментов, которые создают, меняют или удаляют записи в аккаунте. Результаты гонок и правки тренировок он хранит в локальных файлах с журналом изменений.

Где хранятся токены доступа?

У локальных вариантов — в ~/.whoop-mcp/tokens.json с правами 0600. Whoop MCP Server хранит только зашифрованные токены WHOOP (AES-256-GCM), сами данные о здоровье он не сохраняет.

Как подключить WHOOP MCP к Claude Code?

Выполните npx -y whoop-ai-mcp@latest setup --client=claude-code, введите Client ID и Client Secret и выполните команду регистрации, которую выведет мастер. Затем перезапустите клиент: при первом запуске WHOOP откроется в браузере для подтверждения.

Как подключить WHOOP к Claude.ai или ChatGPT?

Нужен удалённый сервер с https-адресом /mcp. Whoop MCP Server добавляется как свой коннектор: в Claude.ai это Customize → Connectors → + → Add custom connector, дальше вход по MCP_AUTH_PASSWORD.

Работает ли сервер из России?

Сервер запрашивает данные с api.prod.whoop.com, поэтому нужны браслет с активным членством WHOOP и доступ к этому адресу из вашей сети.

WHOOP MCP: данные браслета в Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы