RomanEvstigneev/whoop-mcp-server

🏃‍♂️ Whoop MCP Server

A Model Context Protocol (MCP) server that provides Claude Desktop with secure access to your Whoop fitness and health data. Get insights about your sleep, recovery, workouts, and more directly through conversations with Claude.

🌟 Features

8 Powerful MCP Tools

• 🛌 Sleep Data - Detailed sleep tracking including stages, efficiency, and disturbances
• 🔄 Recovery Data - Recovery scores based on HRV, RHR, and sleep quality
• 💪 Workout Data - Exercise sessions, duration, strain, and calories burned
• ⚡ Strain Data - Daily strain scores and stress measurements
• ❤️ Heart Rate Data - Continuous heart rate and HRV monitoring
• 📊 Daily Summary - Consolidated daily overview combining all metrics
• 👤 User Profile - Basic profile information and preferences
• 📏 Body Measurements - Height, weight, and maximum heart rate

🔒 Privacy & Security

• Local Processing - All data processing happens on your machine
• No Data Storage - No health data is stored by this server
• Secure Authentication - OAuth 2.0 with refresh token handling
• Rate Limiting - Built-in API rate limiting and error handling

🚀 Quick Start

Prerequisites

• Node.js 18+
• Active Whoop device and membership
• Claude Desktop installed

Installation

# Clone the repository
git clone https://github.com/RomanEvstigneev/whoop-mcp-server.git
cd whoop-mcp-server

# Run automated setup
npm run setup

# Get your OAuth tokens
npm run oauth

# Test the server
npm test

Configuration

1. Create Whoop Developer App

   • Visit developer.whoop.com
   • Create a new app
   • Note your Client ID and Client Secret

2. Configure Environment

   # Edit .env file with your credentials
   WHOOP_CLIENT_ID=your_client_id
   WHOOP_CLIENT_SECRET=your_client_secret
   WHOOP_REFRESH_TOKEN=your_refresh_token
   

3. Add to Claude Desktop

   • Open Claude Desktop configuration
   • Add the server configuration (see )
   • Restart Claude Desktop

📚 Documentation

• - Complete step-by-step setup guide
• - Detailed configuration instructions
• - Data handling and privacy information
• - Complete API documentation

🗣️ Usage Examples

Once configured, you can ask Claude Desktop:

"Show me my sleep data for the last week"
"What was my recovery score yesterday?"
"Get my workout data for this month"
"Show me my daily summary for today"
"How has my HRV trended over the past month?"
"What's my average strain score this week?"

🔧 Development

Project Structure

whoop-mcp-server/
├── src/
│   └── index.js              # Main MCP server
├── docs/                     # Documentation
├── .github/                  # GitHub templates
├── tests/                    # Test files
├── package.json             # Dependencies
├── README.md               # This file
├── PRIVACY.md              # Privacy policy
└── LICENSE                 # MIT license

Scripts

npm start          # Start the MCP server
npm test           # Run tests
npm run oauth      # OAuth token helper
npm run setup      # Automated setup

🤝 Contributing

We welcome contributions! Please see our for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

🐛 Issues & Support

• Bug Reports: Use our
• Feature Requests: Use our
• Questions: Check our discussions

📄 License

This project is licensed under the MIT License - see the file for details.

⚖️ Privacy & Legal

• Privacy Policy:
• Security Policy:
• This project is not affiliated with Whoop Inc.
• Use of the Whoop API is subject to Whoop's Terms of Service

🙏 Acknowledgments

• Whoop for providing the API
• Anthropic for the MCP specification
• Claude Desktop for the integration platform

⚠️ Important: This server requires your Whoop API credentials. Please review our to understand how your data is handled. Your health data never leaves your machine and is only used to respond to your requests through Claude Desktop.