WHOOP MCP Server for Poke

Connect your WHOOP fitness data to Poke AI using the Model Context Protocol (MCP). This server lets you ask natural language questions about your WHOOP metrics and receive structured, actionable responses in Poke.

How to use

You connect the MCP server to Poke, then ask questions like “What’s my recovery score today?” or “Show me my strain data.” The server handles authentication with WHOOP, fetches your latest data, and returns clear metrics and insights through Poke. Use flexible natural language to retrieve daily metrics, sleep analysis, recovery details, strain tracking, and healthspan information.

How to install

Prerequisites: You need Python 3.10 or higher and a Render account (free tier works). You also need a WHOOP account with an active subscription and a Poke account for AI integration.

Option 1: Deploy to Render (Recommended)

{
  "type": "http",
  "name": "whoop_mcp",
  "url": "https://your-service-name.onrender.com/mcp",
  "args": []
}

Configure your deployment as follows: Name: whoop-mcp-server (or your choice), Branch: main. Set environment variables WHOOP_EMAIL and WHOOP_PASSWORD with your WHOOP credentials. After the deployment finishes (roughly 5–10 minutes), your MCP URL will be available at the Render endpoint above.

Option 2: Run Locally

# Clone the project
git clone https://github.com/kabirrgrover/whoop-mcp-poke.git
cd whoop-mcp-poke

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your WHOOP credentials

# Run the server
python src/server.py

# Server runs at: http://localhost:8000/mcp

Configuration

Environment variables to set for the MCP server are shown below. They are used by the server to authenticate with WHOOP and run the MCP endpoint.

{
  "mcpServers": [
    {
      "type": "http",
      "name": "whoop_mcp",
      "url": "https://your-service-name.onrender.com/mcp",
      "args": []
    },
    {
      "type": "stdio",
      "name": "whoop_mcp_local",
      "command": "python",
      "args": ["src/server.py"],
      "env": [
        {"name": "WHOOP_EMAIL", "value": "<YOUR_WHOOP_EMAIL>"},
        {"name": "WHOOP_PASSWORD", "value": "<YOUR_WHOOP_PASSWORD>"}
      ]
    }
  ]
}

Security

Credentials are stored in environment variables only and never logged or exposed. WHOOP tokens auto-refresh, HTTPS is used for all calls, and AWS Cognito handles authentication when applicable. Avoid committing the environment file and rotate credentials if exposed.

Troubleshooting

If authentication fails, verify your WHOOP email and password in the environment variables and try logging into https://www.whoop.com with those credentials. Confirm your WHOOP subscription is active.

If the MCP server URL is invalid in Poke, ensure the URL exactly matches the deployed endpoint and that the service is running with a green status.

If the server runs but returns no data, confirm your WHOOP subscription is active and that you have recent data on the account. You can query a specific date to check data availability.

Tools and data you can access with Poke

Overview Data — retrieve daily recovery, strain, sleep, calories burned, HRV, RHR trends, and today's activities.

Sleep Analysis — get sleep performance, hours slept vs needed, consistency, efficiency, and insights.

Recovery Metrics — obtain the recovery score, HRV and RHR trends, respiratory rate, and coach insights.

Strain Tracking — view strain score, heart rate zone distribution, time in strength activities, steps, and individual workouts.

Healthspan — check WHOOP Age, aging pace, and weekly trends.

Available tools

Overview Data

Retrieves daily metrics including recovery, strain, sleep, calories burned, HRV, RHR trends, and today's activities.

Sleep Analysis

Analyzes last night's sleep providing performance, hours slept, consistency, efficiency, and actionable insights.

Recovery Metrics

Returns the recovery score (0-100%), HRV and RHR trends, respiratory rate, and coaching insights.

Strain Tracking

Shows strain score, heart rate zones, strength activity time, steps, and individual workouts.

Healthspan

Displays WHOOP Age, aging pace, and weekly trends.