Health MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
pip install -r requirements.txt
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add health-mcp -- python "<FULL_PATH_TO_HEALTH_MCP>/dist/index.js"

Replace <FULL_PATH_TO_HEALTH_MCP>/dist/index.js with the actual folder you prepared in step 1.

README.md

Aggregates and analyzes health and fitness data from multiple sources.

Health MCP Server

A Model Context Protocol (MCP) server for aggregating and analyzing health and fitness data from multiple sources. Currently supports Whoop and Strava with an extensible adapter architecture for future integrations (Withings, Oura, Garmin, etc.).

Features

Multi-Provider Support

  • Modular Architecture: Each adapter is optional and independently configurable
  • Auto-Enable: Adapters are automatically enabled when credentials are configured
  • Unified Auth: Single OAuth callback server shared across all providers

Whoop Integration

  • Sleep Analysis: Track sleep duration, stages (deep, REM, light), efficiency, and consistency
  • Recovery Tracking: Monitor recovery scores, HRV, resting heart rate, and SpO2
  • Strain Monitoring: View daily strain, workout history, and heart rate zones
  • Advanced Insights: Get personalized recommendations, trend analysis, and correlations

Strava Integration

  • Activity Tracking: View runs, rides, swims, and all activity types with full stats
  • Performance Metrics: Distance, pace, speed, elevation, heart rate, power, and cadence
  • Training Zones: Heart rate and power zone configuration and per-activity distribution
  • Athlete Stats: All-time totals, year-to-date, and recent activity summaries
  • Gear Tracking: Monitor distance on bikes, shoes, and other equipment

Available Tools

General

Tool Description
list_adapters List all available adapters and their authentication status

Whoop Tools

Authentication
Tool Description
whoop_authenticate Initiate OAuth2 login flow for Whoop
whoop_check_auth Check current authentication status
Profile
Tool Description
get_user_profile Get user profile and body measurements
Sleep
Tool Description
get_sleep_summary Recent sleep with performance, stages, and needs
get_sleep_history Sleep history over date range with trends
Recovery
Tool Description
get_recovery_score Latest recovery with HRV and status
get_recovery_history Recovery trends over time
Strain & Workouts
Tool Description
get_strain_today Current day strain and heart rate
get_strain_history Daily strain patterns over time
get_workout_history Workout details with HR zones and calories
Analysis & Insights
Tool Description
get_health_overview Comprehensive health dashboard
analyze_sleep_patterns Sleep timing, consistency, and recommendations
analyze_recovery_factors Correlations affecting recovery
get_weekly_report Week-over-week comparison with trends
get_training_readiness Workout intensity recommendations

Strava Tools

Authentication
Tool Description
strava_authenticate Initiate OAuth2 login flow for Strava
strava_check_auth Check current Strava authentication status
Profile & Stats
Tool Description
get_strava_profile Athlete profile with all-time stats and gear
Activities
Tool Description
get_strava_activities Recent activities with distance, pace, HR, etc.
get_strava_activity_detail Detailed activity with laps, segments, and full stats
get_strava_weekly_summary Weekly training summary by activity type
Training Zones
Tool Description
get_strava_zones Your configured HR and power training zones
get_strava_activity_zones Zone distribution for a specific activity

Installation

Prerequisites

  • Python 3.10 or higher
  • API credentials for at least one provider (Whoop and/or Strava)

Setup

  1. Clone the repository

    cd /path/to/health_mcp

  2. Create a virtual environment

    python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

  3. Install dependencies

    pip install -r requirements.txt

  4. Configure API credentials

    Copy the example configuration:

    cp config.example.yaml config.yaml

    Edit config.yaml with your API credentials (configure one or both):

    # Whoop - Get credentials from https://developer.whoop.com/
whoop:
  client_id: "your_client_id_here"
  client_secret: "your_client_secret_here"
  redirect_uri: "http://localhost:8787/callback"

# Strava - Get credentials from https://www.strava.com/settings/api
strava:
  client_id: "your_client_id_here"
  client_secret: "your_client_secret_here"
  redirect_uri: "http://localhost:8787/callback"

    Alternative: Environment Variables

    # Whoop
export HEALTH_MCP_WHOOP_CLIENT_ID="your

Tools (24)

list_adaptersList all available adapters and their authentication status
whoop_authenticateInitiate OAuth2 login flow for Whoop
whoop_check_authCheck current authentication status
get_user_profileGet user profile and body measurements
get_sleep_summaryRecent sleep with performance, stages, and needs
get_sleep_historySleep history over date range with trends
get_recovery_scoreLatest recovery with HRV and status
get_recovery_historyRecovery trends over time
get_strain_todayCurrent day strain and heart rate
get_strain_historyDaily strain patterns over time
get_workout_historyWorkout details with HR zones and calories
get_health_overviewComprehensive health dashboard
analyze_sleep_patternsSleep timing, consistency, and recommendations
analyze_recovery_factorsCorrelations affecting recovery
get_weekly_reportWeek-over-week comparison with trends
get_training_readinessWorkout intensity recommendations
strava_authenticateInitiate OAuth2 login flow for Strava
strava_check_authCheck current Strava authentication status
get_strava_profileAthlete profile with all-time stats and gear
get_strava_activitiesRecent activities with distance, pace, HR, etc.
get_strava_activity_detailDetailed activity with laps, segments, and full stats
get_strava_weekly_summaryWeekly training summary by activity type
get_strava_zonesYour configured HR and power training zones
get_strava_activity_zonesZone distribution for a specific activity

Environment Variables

HEALTH_MCP_WHOOP_CLIENT_IDWhoop API client ID
HEALTH_MCP_WHOOP_CLIENT_SECRETWhoop API client secret
HEALTH_MCP_STRAVA_CLIENT_IDStrava API client ID
HEALTH_MCP_STRAVA_CLIENT_SECRETStrava API client secret

Configuration

claude_desktop_config.json
{"mcpServers": {"health": {"command": "python", "args": ["/path/to/health_mcp/main.py"], "env": {"HEALTH_MCP_WHOOP_CLIENT_ID": "...", "HEALTH_MCP_WHOOP_CLIENT_SECRET": "...", "HEALTH_MCP_STRAVA_CLIENT_ID": "...", "HEALTH_MCP_STRAVA_CLIENT_SECRET": "..."}}}}

Try it

→Analyze my sleep patterns from the last week and suggest improvements.
→What was my average recovery score over the last 7 days?
→Summarize my recent Strava activities and highlight my longest run.
→Based on my current recovery and strain, should I do a high-intensity workout today?
→Compare my heart rate zones from my last three cycling sessions.

Frequently Asked Questions

What are the key features of Health MCP Server?

Modular adapter architecture for Whoop and Strava. Unified OAuth authentication flow for multiple providers. Comprehensive sleep, recovery, and strain analysis. Detailed Strava activity tracking and performance metrics. Personalized health insights and trend reporting.

What can I use Health MCP Server for?

Athletes wanting to correlate sleep quality with training performance.. Users needing a unified dashboard for multi-platform fitness data.. Individuals looking for AI-driven recommendations based on recovery scores.. Cyclists tracking gear usage and training zone distribution..

How do I install Health MCP Server?

Install Health MCP Server by running: pip install -r requirements.txt

What MCP clients work with Health MCP Server?

Health MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Health MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all other servers →

Related MCP Servers

Nuclear
Free, open-source music player without ads or tracking.
other17.1K stars
Domain Check
Fast domain availability checker with RDAP/WHOIS lookup and batch checking.
other253 stars
Ableton MCP Extended
Control Ableton Live using natural language via AI assistants
other142 stars
US Government Open Data MCP
MCP Server + TypeScript SDK for 40+ U.S. Government APIs
other90 stars
Garmin Connect
Access your fitness, health, and training data from MCP clients.
other71 stars
BinjaLattice MCP
Secure communication protocol for Binary Ninja and MCP servers
other61 stars