romanevstigneev/whoop-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

27 stars 8 forks 품질 66 트렌드 11MIT

Repository Install

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

개요

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. 🚀 : Try the Smithery hosted version for zero-setup deployment! 🔐 - Safe WHOOP account connection with encrypted local storage 🏃 - Workouts, recovery, sleep, cycles, and profile information 🤖 - Ask Claude about your fitness data in plain English ⚡ - Optimized performance with intelligent data caching 🛡️ - All data stays on your machine, never sent to third parties 🔄 - Seamless experience with automatic authentication renewal - ✅ Zero installation complexity - ✅ Automatic updates and maintenance - ✅ Enterprise-grade hosting - ➡️ - ✅ Full control and privacy - ✅ No external dependencies - ✅ Customize and extend - ➡️ - Python 3.

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

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:

Open WHOOP OAuth Page: 👉 Click here to authorize WHOOP access
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

GitHub에서 전체 README 보기

설치

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