ryanlisse_whoop_api_mcp

ryanlisse_whoop_api_mcp

by RyanLisse

Resources

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

RyanLisse / whoop-api-mcp Public

MCP server for interacting with the Whoop API to retrieve fitness and health data

1 star
0 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

RyanLisse/whoop-api-mcp

main

Branches
Tags


Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------

History
-------

8 Commits

| | |
| src | | src | | |
| .env.example | | .env.example | | |
| README.md | | README.md | | |
| mcp.json | | mcp.json | | |
| package.json | | package.json | | |
| View all files | | |

Repository files navigation

Whoop API MCP Server

An MCP (Mission Control Protocol) server for interacting with the Whoop API to retrieve fitness and health data.

Overview

This MCP server provides a standardized interface for accessing Whoop fitness data through its API. It handles authentication, data retrieval, and formatting to make it easy to integrate Whoop data into your applications.

Features

  • OAuth 2.0 authentication with Whoop API
  • User profile information
  • Recovery data
  • Sleep data
  • Workout data
  • Menstrual cycle tracking data
  • MCP-compliant discovery endpoint
  • Clean error handling and logging

Prerequisites

  • Node.js 16.x or higher
  • Whoop developer account and API credentials
  • Register your app
    in the Whoop Developer Portal

Installation

  1. Clone the repository:

    git clone https://github.com/RyanLisse/whoop-api-mcp.git
cd whoop-api-mcp

  2. Install dependencies:

    npm install

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

    cp .env.example .env

  4. Update the .env file with your Whoop API credentials:

    WHOOP_CLIENT_ID=your_client_id_here
WHOOP_CLIENT_SECRET=your_client_secret_here
WHOOP_REDIRECT_URI=http://localhost:3000/auth/callback

Usage

  1. Start the server:

    npm start

  2. The MCP endpoint will be available at:

    http://localhost:3000/.well-known/mcp.json

  3. To authenticate a user with Whoop, direct them to:

    http://localhost:3000/auth/login

  4. After authentication, you'll receive access and refresh tokens to use with the API endpoints.

Endpoints

  • GET /user - Get user profile information
  • GET /user/membership - Get user membership information
  • GET /recovery?start=YYYY-MM-DD&end=YYYY-MM-DD - Get recovery data for a date range
  • GET /recovery/latest - Get most recent recovery data
  • GET /sleep?start=YYYY-MM-DD&end=YYYY-MM-DD - Get sleep data for a date range
  • GET /workout?start=YYYY-MM-DD&end=YYYY-MM-DD - Get workout data for a date range
  • GET /cycle?start=YYYY-MM-DD&end=YYYY-MM-DD - Get menstrual cycle data for a date range

Whoop API Documentation

For more information about the Whoop API, refer to the official Whoop API documentation
.

MCP Specification

This server follows the MCP (Mission Control Protocol) specification. The MCP discovery endpoint is available at /.well-known/mcp.json.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

About

MCP server for interacting with the Whoop API to retrieve fitness and health data

Resources

Readme

Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

You can’t perform that action at this time.

Features & Capabilities

Categories
mcp_server model_context_protocol

Implementation Details

View on GitHub

Stats

0 Views
1 GitHub Stars

Repository Info

RyanLisse Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI