🏃 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
     • offline - Refresh token for continued access

3. Copy Authorization Code:

   • After authorization, you'll see a success page
   • Copy the entire authorization code (long string starting with letters/numbers)
   • It looks like: ABC123...XYZ789 (much longer)

4. Exchange Code for Tokens:

   python -c "
   import sys
   sys.path.insert(0, './src')
   from auth_manager import TokenManager
   import requests
   
   # Paste your authorization code here
   auth_code = 'YOUR_AUTHORIZATION_CODE_HERE'
   
   # Exchange for tokens
   url = f'https://personal-integrations-462307.uc.r.appspot.com/api/get-tokens/{auth_code}'
   response = requests.get(url, timeout=30)
   
   if response.status_code == 200:
       token_data = response.json()
       if token_data.get('success'):
           # Save tokens
           token_manager = TokenManager()
           token_manager.save_tokens(token_data)
           print('✅ Tokens saved successfully!')
       else:
           print('❌ Token exchange failed
   

... View full README on GitHub