Skip to main content
Glama
Garmin Health MCP Server

Garmin Health MCP Server

by willc121

Garmin Health MCP Server

Query your Garmin health data in plain English through Claude Desktop.

Live Demo & Full Writeup →

Quick Start

Prerequisites

  • Node.js 18+

  • Claude Desktop

  • Garmin data in Supabase

Install

git clone https://github.com/willc121/garmin-health-mcp-server.git
cd garmin-health-mcp-server
npm install
npm run build

Configure Claude Desktop

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "garmin": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "SUPABASE_URL": "your-supabase-url",
        "SUPABASE_ANON_KEY": "your-supabase-anon-key"
      }
    }
  }
}

Restart Claude Desktop. The Garmin connector should appear in your connectors menu.

Related MCP server: garmin-mcp

Available Tools

Tool

Description

get_health_summary

Overview of all health data

get_vo2max

VO2 max history and trends

get_activities

Activity breakdown by type

get_sleep

Sleep statistics

get_race_predictions

Predicted race times

get_heart_rate_zones

Personalized HR training zones

get_training_load

Acute/chronic workload ratio

Example Queries

What's my VO2 max?
Am I overtraining?
Compare my running vs cycling this year

Getting Your Garmin Data

1. Request your data export

2. Wait for the email

Garmin sends a download link within 48 hours. The export can be several GB depending on how long you've been tracking.

3. Download and extract

You'll get a zip with JSON files for activities, sleep, VO2 max, heart rate, and more.

4. Load into a database

The raw export is too large to query directly (mine was 9 years of data), so I loaded it into Supabase (free tier works fine).

You'll need these tables:

  • vo2_max — VO2 max readings by date and sport

  • activities — Activity records with type, duration, distance, HR

  • sleep_summary — Aggregated sleep stats

  • race_predictions — Garmin's predicted race times

  • heart_rate_zones — HR zone boundaries

  • training_load — Daily training load metrics

I wrote Python scripts to parse the Garmin JSON and insert into Supabase. Happy to share if there's interest — open an issue.

Troubleshooting

Problem

Fix

Connector doesn't appear

Check JSON syntax, use absolute path, fully restart Claude

Connection errors

Verify Supabase credentials

License

MIT


🏃 Powered by questionable cardio and an unhealthy amount of VO2 max anxiety. No treadmills were harmed in the making of this server.

Available Tools

7 tools
get_activitiesC

Get activity breakdown by type, including counts, distances, and durations

Inputs: start_date, end_date, activity_type.

get_health_summaryB

Get an overview of all health data including VO2 max, activities, sleep, and race predictions

Inputs: no named parameters.

get_heart_rate_zonesB

Get personalized heart rate training zones based on max HR and lactate threshold

Inputs: no named parameters.

get_race_predictionsB

Get predicted race times for 5K, 10K, half marathon, and marathon based on current fitness

Inputs: no named parameters.

get_sleepC

Get sleep statistics including average duration and total nights tracked. Optionally filter by date range.

Inputs: start_date, end_date.

get_training_loadB

Get training load data including acute/chronic workload ratio to assess overtraining risk

Inputs: days.

get_vo2maxC

Get VO2 max history and trends. VO2 max measures cardiovascular fitness in ml/kg/min.

Inputs: start_date, end_date, sport.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific health and fitness data domains, such as activities, health summary, heart rate zones, race predictions, sleep, training load, and VO2 max. There is no overlap in functionality, and an agent can easily differentiate between them based on their descriptive names and scopes.

    Naming Consistency5/5

    All tool names follow a consistent 'get_' prefix pattern with descriptive nouns, such as get_activities, get_health_summary, and get_heart_rate_zones. This uniformity makes the tool set predictable and easy to navigate, adhering to a clear verb_noun convention throughout.

    Tool Count5/5

    With 7 tools, the server is well-scoped for a health and fitness data domain, covering key aspects like activities, sleep, training metrics, and predictions. Each tool serves a distinct purpose without redundancy, making the count appropriate and manageable for the server's intended use.

    Completeness4/5

    The tool set provides comprehensive read-only coverage for retrieving health and fitness data, including summaries, detailed metrics, and predictions. A minor gap exists in the lack of write or update operations, but for a data retrieval-focused server, this is reasonable and agents can work effectively with the available tools.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables querying and analyzing personal Strava activity data through natural language, including activities, segments, gear, and training trends.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to query live Garmin Connect health and fitness data, including daily metrics, activities, sleep analysis, and trends via natural language.
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to retrieve and analyze Garmin Connect health data, including daily summaries, sleep, HRV, workouts, and raw FIT files, while also supporting SQL queries on the underlying database.
      10
      -