RyanLisse/whoop-mcp-server
If you are the rightful owner of whoop-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP (Machine Conversation Protocol) server implementation for the WHOOP API.
WHOOP MCP Server
An MCP (Machine Conversation Protocol) server implementation for the WHOOP API.
Overview
This project provides a server that interfaces with the WHOOP API, allowing you to interact with your WHOOP fitness data. It follows the MCP architecture pattern, which enables interoperability with AI assistants.
Features
- Access to WHOOP user profile data
- Retrieve sleep data and analytics
- Fetch workout information
- Get recovery metrics
- View cycle data
Prerequisites
- Node.js (v16+)
- WHOOP account with API access
- WHOOP API key (obtained from WHOOP Developer Portal)
Installation
-
Clone this repository:
git clone https://github.com/RyanLisse/whoop-mcp-server.git cd whoop-mcp-server -
Install dependencies:
npm install -
Create a
.envfile based on the.env.exampletemplate:cp .env.example .env -
Edit the
.envfile and add your WHOOP API key and other configuration options.
Usage
Starting the Server
npm start
For development with auto-restart:
npm run dev
The server will start on the port specified in your .env file (default: 3000).
API Endpoints
All API endpoints require authentication with your WHOOP API key.
User Profile
GET /whoop/profile- Get user profile information
Sleep Data
GET /whoop/sleep?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD- Get sleep data for the specified date range
Workout Data
GET /whoop/workouts?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD- Get workout data for the specified date range
Recovery Data
GET /whoop/recovery?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD- Get recovery data for the specified date range
Cycle Data
GET /whoop/cycles?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD- Get cycle data for the specified date range
Authentication
Add your WHOOP API token to the Authorization header in your requests:
Authorization: Bearer YOUR_WHOOP_API_TOKEN
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
