WHOOP Fitness Data Server is an MCP server that connects Claude Desktop to your WHOOP wearable fitness tracker, enabling natural language queries about your health and performance metrics. Key features of WHOOP Fitness Data Server: - Secure OAuth authentication with encrypted local token storage - Access to comprehensive WHOOP data including workouts, recovery scores, sleep quality, cycle metrics, and profile information - Smart caching for optimized performance and reduced API calls - Automatic token refresh for seamless continuous access - Privacy-first architecture keeping all fitness data local on your machine - Natural language interface allowing conversational queries about your fitness and recovery metrics

🏃 WHOOP MCP Server

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

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io/) [](https://smithery.ai/server/@RomanEvstigneev/whoop-mcp-server)

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)

Option B: Local Installation (Advanced users)

---

📦 Local Installation

1. Prerequisites

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:

#### 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')
   else:
       print(f'❌ HTTP Error: {response.status_code}')
   "
   

5. Verify Setup:

   python -c "
   import sys
   sys.path.insert(0, './src')
   from whoop_client import WhoopClient
   client = WhoopClient()
   print(f'✅ Auth status: {client.get_auth_status()}')
   "
   

4. Configure Claude Desktop

Add to your Claude Desktop settings:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\\Claude\\claude_desktop_config.json Linux: ~/.config/claude/claude_desktop_config.json

{
  "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"
      }
    }
  }
}

⚠️ Important: Use the full Python path (find yours with which python3)

5. Restart Claude Desktop

After adding the configuration, restart Claude Desktop to load the WHOOP serv