通过模型上下文协议（MCP）将您的WHOOP健身数据连接到Claude Desktop。

通过Claude Desktop中的自然语言查询，将你的WHOOP健身数据转化为可操作的洞察。提出关于锻炼、恢复、睡眠模式等问题——同时保持数据安全和隐私。

🚀 新：试试Smithery托管版本，实现零设置部署！

✨ 特色

🔐 安全OAuth集成 - 安全WHOOP账户连接，带加密本地存储 🏃 完整数据访问 - 锻炼、恢复、睡眠、周期和个人资料信息 🤖 自然语言查询 - 用通俗易懂的英语向Claude询问你的健身数据 ⚡ 智能缓存——智能数据缓存优化性能 🛡️ 隐私优先 - 所有数据都留在您的机器上，绝不发送给第三方 🔄 自动令牌刷新 - 自动认证更新的无缝体验

🚀 快速启动

🎯 选择你的部署方式

选项A：Smithery Hosted（推荐初学者）

• ✅ 零安装复杂性
• ✅ 自动更新与维护
• ✅ 企业级托管
• ➡️ 开始使用史密瑟里

🏃 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

Option A: Interactive Setup (Recommended)

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