jedpattersonn/whoop-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

13 stars 15 forks 품질 65 트렌드 20MIT

Repository Install

MCP server for WHOOP - integrate your fitness and biometric data with Claude and other LLMs

개요

A Model Context Protocol (MCP) server for accessing Whoop fitness data. Integrate your WHOOP biometric data into Claude, LLMs, and other MCP-compatible applications. - - All your daily metrics in one call - - Deep dive into sleep performance and quality - - HRV, RHR, and recovery contributors - - Day strain with heart rate zones and activities - - Biological age and pace of aging metrics The server will run on http://localhost:3000/mcp by default. The --env-file .env flag automatically loads all environment variables from your .env file. The Docker image is based on the official Bun Alpine image. The container includes health checks to monitor the server's status. This server is configured to work with Smithery, a platform for deploying MCP servers. When deployed on Smithery: 1. : Smithery passes your credentials as query parameters to the /mcp endpoint (defined in smithery.

README

원문 README의 일부입니다. 원문 보기.

Whoop MCP Server

A Model Context Protocol (MCP) server for accessing Whoop fitness data. Integrate your WHOOP biometric data into Claude, LLMs, and other MCP-compatible applications.

Features

Comprehensive Overview - All your daily metrics in one call
Sleep Analysis - Deep dive into sleep performance and quality
Recovery Metrics - HRV, RHR, and recovery contributors
Strain Tracking - Day strain with heart rate zones and activities
Healthspan - Biological age and pace of aging metrics

Quick Start

Clone the repository:

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

Create a .env file with your WHOOP credentials:

echo "[email protected]" > .env
echo "WHOOP_PASSWORD=your-password" >> .env
echo "PORT=3000" >> .env

Or set as environment variables:

export WHOOP_EMAIL='[email protected]'
export WHOOP_PASSWORD='your-password'

Install dependencies:

bun install

Start the server:

bun run start

Or for development with hot reload:

bun run dev

The server will run on http://localhost:3000/mcp by default.

Docker Deployment

Create a .env file with your credentials:

cp .env.example .env
# Edit .env with your actual credentials

Build the Docker image:

docker build -t whoop-mcp .

Run the container:

docker run -d \
  --name whoop-mcp \
  whoop-mcp

The --env-file .env flag automatically loads all environment variables from your .env file.

View logs:

docker logs -f whoop-mcp

Stop the container:

docker stop whoop-mcp

The Docker image is based on the official Bun Alpine image. The container includes health checks to monitor the server’s status.

Smithery Deployment

This server is configured to work with Smithery, a platform for deploying MCP servers. When deployed on Smithery:

Configuration via Query Parameters: Smithery passes your credentials as query parameters to the /mcp endpoint (defined in smithery.yaml):
- whoopEmail - Your Whoop account email
- whoopPassword - Your Whoop account password
- mcpAuthToken - Optional authentication token
Automatic Configuration: The server automatically extracts these from query parameters when running on Smithery, so you don’t need to set environment variables manually.
Deploy Button: Use the Railway deploy button above for quick deployment, or follow Smithery’s documentation for other deployment options.

The smithery.yaml file in the repository root defines the configuration schema that Smithery uses to collect your credentials securely.

GitHub에서 전체 README 보기

설치

docker run -d \

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "whoop": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/whoop-mcp/index.ts"],
      "env": {
        "WHOOP_EMAIL": "[email protected]",
        "WHOOP_PASSWORD": "your-password"
      }
    }
  }
}