RW

romanevstigneev/whoop-mcp-server

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

27 stars 8 forks Качество 66 Тренд 11MIT

Подключите свои данные о фитнесе WHOOP к Claude Desktop через протокол Model Context Protocol (MCP)

Обзор

Подключите свои данные о фитнесе WHOOP к Claude Desktop через протокол Model Context Protocol (MCP). Преобразуйте свои фитнес-данные WHOOP в практические идеи с помощью запросов на естественном языке в Claude Desktop. Задавайте вопросы о ваших тренировках, восстановлении, моделях сна и многом другом, сохраняя ваши данные в безопасности и конфиденциальности. Попробуйте версию Smithery для развертывания с нулевой настройкой! - Безопасное соединение учетной записи WHOOP с зашифрованным локальным хранилищем - тренировки, восстановление, сон, циклы и информация о профиле - Спросите Клода о ваших данных о фитнесе на простом английском языке - Оптимизированная производительность с интеллектуальным кэшированием данных ️ - Все данные остаются на вашей машине, никогда не отправляемые третьим лицам - Бесшовный опыт с автоматическим обновлением аутентификации Нулевая сложность установки - Автоматические обновления и техническое обслуживание - хостинг корпоративного уровня - ️ • Полный контроль и конфиденциальность — • Отсутствие внешних зависимостей — • Настройка и расширение — ️ - Python 3.

Обзор (машинный перевод)

Подключите свои фитнес-данные WHOOP к Claude Desktop через протокол Model Context Protocol (MCP)

Преобразуйте свои фитнес-данные WHOOP в практические идеи с помощью запросов на естественном языке в Claude Desktop. Задавайте вопросы о ваших тренировках, восстановлении, моделях сна и многом другом, сохраняя ваши данные в безопасности и конфиденциальности.

Новое: Попробуйте версию Smithery для развертывания с нулевой настройкой!

Feature Особенности

Безопасная интеграция OAuth - безопасное соединение учетной записи WHOOP с зашифрованным локальным хранилищем Полный доступ к данным ** - тренировки, восстановление, сон, циклы и информация о профиле

    • Естественные языковые запросы * * - Спросите Клода о ваших данных о фитнесе на простом английском языке Умное кэширование - оптимизированная производительность с интеллектуальным кэшированием данных riv️ **Конфиденциальность Первый ** - Все данные остаются на вашем компьютере, никогда не отправляемые третьим лицам Auto Token Refresh - Бесшовный опыт автоматического обновления аутентификации

Быстрый старт

###Выберите метод развертывания

Вариант A: Smithery Hosted (рекомендуется для начинающих) Нулевая сложность установки Автоматические обновления и техническое обслуживание

  • хостинг корпоративного уровня Начните с Смитери

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

🏃 WHOOP MCP Server

Connect your WHOOP fitness data to Claude Desktop through the Model Context Protocol (MCP)

Transform your WHOOP fitness data into actionable insights through natural language queries in Claude Desktop. Ask questions about your workouts, recovery, sleep patterns, and more - all while keeping your data secure and private.

🚀 NEW: Try the Smithery hosted version for zero-setup deployment!

✨ Features

🔐 Secure OAuth Integration - Safe WHOOP account connection with encrypted local storage
🏃 Complete Data Access - Workouts, recovery, sleep, cycles, and profile information
🤖 Natural Language Queries - Ask Claude about your fitness data in plain English
⚡ Smart Caching - Optimized performance with intelligent data caching
🛡️ Privacy First - All data stays on your machine, never sent to third parties
🔄 Auto Token Refresh - Seamless experience with automatic authentication renewal

🚀 Quick Start

🎯 Choose Your Deployment Method

Option A: Smithery Hosted (Recommended for beginners)

  • ✅ Zero installation complexity
  • ✅ Automatic updates and maintenance
  • ✅ Enterprise-grade hosting
  • ➡️ Get started with Smithery

Option B: Local Installation (Advanced users)

  • ✅ Full control and privacy
  • ✅ No external dependencies
  • ✅ Customize and extend
  • ➡️ Continue with local setup below

📦 Local Installation

1. Prerequisites

  • Python 3.8+
  • Claude Desktop
  • Active WHOOP account

2. Installation

git clone https://github.com/romanevstigneev/whoop-mcp-server.git
cd whoop-mcp-server
pip install -r requirements.txt

3. Setup

Run the interactive setup:

python setup.py

This will:

  • Open your browser for WHOOP OAuth authorization
  • Securely save your tokens locally
  • Provide Claude Desktop configuration

Option B: Manual WHOOP OAuth Setup

If the interactive setup doesn’t work, you can manually get your WHOOP tokens:

  1. Open WHOOP OAuth Page: 👉 Click here to authorize WHOOP access

  2. Authorize Your Account:

    • Log in with your WHOOP credentials
    • Grant permissions for the requested scopes:
      • read:profile - Access to your profile information
      • read:workout - Access to workout data
      • read:recovery - Access to recovery data
      • read:sleep - Access to sleep data
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "whoop": { "command": "/opt/miniconda3/bin/python", "args": ["/path/to/whoop-mcp-server/src/whoop_mcp_server.py"], "env": { "PYTHONPATH": "/path/to/whoop-mcp-server/src" } } } }