WHOOP MCP Provider

This is a Model Context Protocol (MCP) provider for WHOOP, allowing you to access WHOOP health and fitness data through a standardized interface.

Features

OAuth2 authentication with WHOOP API
Access to WHOOP data including:
- Cycles (daily strain)
- Recovery metrics
- Sleep data
- Workout data
- Body measurements
- User profile information

Setup

Clone this repository
Install dependencies:
```
npm install
```
Create a .env file based on .env.example:
```
cp .env.example .env
```
Get your WHOOP API credentials:
- Go to WHOOP Developer Portal
- Create a new application
- Copy your Client ID and Client Secret
- Set your redirect URI

Update your .env file with your credentials:

WHOOP_CLIENT_ID=your_client_id
WHOOP_CLIENT_SECRET=your_client_secret
WHOOP_REDIRECT_URI=http://localhost:3000/callback

Building

npm run build

Running Tests

npm test

Usage

The provider can be used as a library or as a standalone MCP server:

import { WhoopProvider } from 'whoop-mcp';

const provider = new WhoopProvider({
  clientId: 'your_client_id',
  clientSecret: 'your_client_secret',
  redirectUri: 'your_redirect_uri'
});

Available Resources

whoop://cycle - Daily strain cycles
whoop://recovery - Recovery metrics
whoop://sleep - Sleep data
whoop://workout - Workout data
whoop://body_measurement - Body measurements
whoop://profile - User profile information

License

ISC