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

1. Clone this repository

2. Install dependencies:

   npm install
   

3. Create a .env file based on .env.example:

   cp .env.example .env
   

4. 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

5. 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