whoop

whoop

shashankswe2020-uxMIT
102 звёзд22 форков
WHOOP — фитнес-трекер для глубокого анализа восстановления, сна и нагрузок. MCP-сервер соединяет AI-ассистентов с данными вашего аккаунта WHOOP. Вы задаёте вопросы на естественном языке, а ассистент получает структурированные ответы из вашей статистики. Сервер сам авторизуется через OAuth2, общается с WHOOP API и обрабатывает ответы. Вам не нужно писать код или вручную экспортировать данные.
Design
Открыть на GitHub

Установка

npx -y whoop-ai-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикshashankswe2020-ux
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Получать текущие метрики восстановления, сна и цикла через фоновые ресурсы — инструменты вызывать не нужно.
  • Запрашивать данные за любой период на русском: «на этой неделе», «за последние 3 месяца», «в мае 2025».
  • Просматривать недельные сводки со встроенной аналитикой трендов на основе линейной регрессии.
  • Сравнивать показатели за разные периоды — например, эффективность сна в этом месяце против прошлого.
  • Искать конкретные записи: тренировку, фазы сна или профиль по дате.
  • Получать сводку за сегодня: восстановление, готовность к нагрузке и дневную активность.
  • Выводить календарную сетку с ежедневными данными за выбранный месяц.
  • Использовать 5 готовых шаблонов запросов для быстрого старта.
  • Авторизоваться однократно через браузер — токен обновляется автоматически, пароль не покидает устройство.
  • Не беспокоиться о лимитах API: сервер автоматически выполняет пагинацию и повторяет запросы при ошибках.

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

1. Установка. Запустите команду в терминале. Пакет работает без предварительной установки:

npx -y whoop-ai-mcp

2. Настройка клиента. Укажите сервер в конфигурации вашего MCP-клиента. Пример для Claude Desktop:

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

3. Авторизация. При первом запуске сервер откроет браузер для OAuth2-авторизации. Вам потребуются Client ID и Client Secret от приложения WHOOP. Зарегистрируйте приложение в панели разработчика WHOOP (бесплатно) и укажите Redirect URI http://localhost:3000/callback.

4. Завершение. Токен сохраняется локально в ~/.whoop-mcp/tokens.json с правами доступа 0600. Перезапустите клиент MCP. Сервер готов к работе.

Примеры запросов

  • «Сравни моё восстановление за последние две недели. Есть ли тенденция к улучшению?»
  • «Найди тренировку за 14 марта этого года. Покажи продолжительность и нагрузку.»
  • «Покажи календарь моей активности за февраль 2025.»
  • «Какие мои средние показатели сна за последние 3 месяца? Выведи детализацию по фазам сна.»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Зависимости: 2 (MCP SDK + Zod)
  • Совместимость: Claude Desktop, Continue.dev, Cursor и любые MCP-клиенты
  • Регистрация: MCP Registry (io.github.shashankswe2020-ux/whoop)
  • Хранилище токенов: ~/.whoop-mcp/tokens.json (права 0600)

Поделиться