Skip to main content
Glama

mcp-garmin

MCP server for Garmin Connect health and fitness data. Read-only access to daily health metrics, activities, workouts, and body composition via the python-garminconnect library.

Prerequisites

  • Python 3.14+

  • uv

  • A Garmin Connect account

Related MCP server: Garmin MCP

Authentication

Garmin Connect uses email/password authentication with optional MFA. The library persists session tokens to ~/.garminconnect/garmin_tokens.json after initial login.

First-time setup

Run the interactive login command to establish tokens. This handles MFA prompts:

# Set credentials (or the CLI will prompt you)
export GARMIN_EMAIL="you@example.com"
export GARMIN_PASSWORD="your-password"

# Interactive login -- prompts for MFA if enabled
uvx mcp-garmin-login

Running the server

The MCP server requires GARMIN_EMAIL and GARMIN_PASSWORD environment variables. It reuses tokens saved by the login step and refreshes them automatically.

export GARMIN_EMAIL="you@example.com"
export GARMIN_PASSWORD="your-password"

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": ["mcp-garmin"],
      "env": {
        "GARMIN_EMAIL": "you@example.com",
        "GARMIN_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

claude mcp add garmin -- uvx mcp-garmin

Set GARMIN_EMAIL and GARMIN_PASSWORD in your shell environment.

Tools

All date parameters use ISO format (YYYY-MM-DD).

Daily Health

Tool

Description

get_daily_summary

Steps, calories, distance, active minutes

get_heart_rates

Heart rate data

get_sleep_data

Sleep stages and metrics

get_stress_data

Detailed stress levels

get_all_day_stress

All-day stress summary

get_body_battery

Body Battery (energy) levels

get_steps_data

Detailed step data

get_hrv_data

Heart Rate Variability

get_spo2_data

Blood oxygen saturation

get_respiration_data

Respiratory rate

get_training_readiness

Training readiness score

get_intensity_minutes

Intensity minutes

get_resting_heart_rate

Resting heart rate

Activities

Tool

Description

get_activities

List recent activities (paginated)

get_activities_by_date

Activities within a date range

get_activities_for_date

All activities for a specific date

get_last_activity

Most recent activity

get_activity

Single activity by ID

get_activity_details

Detailed metrics (laps, charts)

get_activity_splits

Split/lap data

get_activity_weather

Weather during activity

get_activity_hr_zones

Heart rate zone distribution

get_activity_gear

Equipment used

get_activity_exercise_sets

Strength training sets

Workouts

Tool

Description

get_workouts

List saved workout templates

get_workout

Single workout by ID

Body Composition

Tool

Description

get_body_composition

Body composition over a date range

get_weigh_ins

Weight measurements over a date range

Profile & Fitness

Tool

Description

get_user_profile

Profile information

get_max_metrics

VO2 max and fitness metrics

get_fitness_age

Calculated fitness age

get_training_status

Training status

get_personal_records

Personal bests

Development

uv sync
uv run pytest tests/ -x -q
uv run ruff check src/ tests/
uv run pyright src/

Available Tools

32 tools
get_activitiesC

List recent activities, newest first.

Args: start: Zero-based index to start from. limit: Maximum number of activities to return (1-100).

Inputs: start, limit. Returns: result

get_activities_by_dateA

Get activities within a date range, optionally filtered by type.

Args: start_date: Start date in YYYY-MM-DD format. end_date: End date in YYYY-MM-DD format. activity_type: Optional activity type filter (e.g. "running", "cycling").

Inputs: start_date (required), end_date (required), activity_type. Returns: result

get_activityB

Get a single activity by its ID.

Args: activity_id: Garmin activity ID.

Inputs: activity_id (required). Returns: result

get_activity_detailsC

Get detailed metrics for an activity (laps, charts, etc.).

Args: activity_id: Garmin activity ID.

Inputs: activity_id (required). Returns: result

get_activity_exercise_setsA

Get strength training exercise sets for an activity.

Args: activity_id: Garmin activity ID.

Inputs: activity_id (required). Returns: result

get_activity_gearB

Get equipment/gear used in an activity.

Args: activity_id: Garmin activity ID.

Inputs: activity_id (required). Returns: result

get_activity_hr_zonesB

Get heart rate zone distribution for an activity.

Args: activity_id: Garmin activity ID.

Inputs: activity_id (required). Returns: result

get_activity_splitsC

Get split/lap data for an activity.

Args: activity_id: Garmin activity ID.

Inputs: activity_id (required). Returns: result

get_activity_weatherC

Get weather conditions during an activity.

Args: activity_id: Garmin activity ID.

Inputs: activity_id (required). Returns: result

get_body_batteryB

Get Body Battery (energy) levels for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_body_compositionB

Get body composition data for a date range.

Args: start_date: Start date in YYYY-MM-DD format. end_date: End date in YYYY-MM-DD format.

Inputs: start_date (required), end_date (required). Returns: result

get_daily_summaryB

Get daily activity summary (steps, calories, distance, active minutes).

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_fitness_ageA

Get calculated fitness age for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_heart_ratesA

Get heart rate data for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_hrv_dataA

Get Heart Rate Variability (HRV) data for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_intensity_minutesB

Get intensity minutes data for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_last_activityB

Get the most recent activity.

Inputs: no named parameters. Returns: result

get_max_metricsA

Get VO2 max and related fitness metrics for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_personal_recordsA

Get personal best records across all activities.

Inputs: no named parameters. Returns: result

get_respiration_dataB

Get respiratory rate data for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_resting_heart_rateB

Get resting heart rate for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_server_versionA

Return the installed version of the mcp-garmin server.

Inputs: no named parameters. Returns: result

get_sleep_dataB

Get sleep stages and metrics for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_spo2_dataA

Get blood oxygen saturation (SpO2) data for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_steps_dataB

Get detailed step data for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_stress_dataC

Get stress levels throughout the day.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_training_readinessA

Get training readiness score for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_training_statusC

Get current training status for a given date.

Args: date: Date in YYYY-MM-DD format.

Inputs: date (required). Returns: result

get_user_profileA

Get the user's Garmin Connect profile information.

Inputs: no named parameters. Returns: result

get_weigh_insB

Get weight measurements for a date range.

Args: start_date: Start date in YYYY-MM-DD format. end_date: End date in YYYY-MM-DD format.

Inputs: start_date (required), end_date (required). Returns: result

get_workoutC

Get a saved workout template by ID.

Args: workout_id: Garmin workout ID.

Inputs: workout_id (required). Returns: result

get_workoutsA

List saved workout templates.

Inputs: no named parameters. Returns: result

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 32 tools

    Disambiguation5/5

    Each tool has a distinct and well-defined purpose, with clear differentiation among activity sub-tools (details, splits, gear, etc.) and between list/single retrieval functions. No two tools appear to do the same thing.

    Naming Consistency5/5

    All tools follow a consistent 'get_<specific_data>' pattern using snake_case, with no mixing of conventions or verb styles. This makes the tool set highly predictable.

    Tool Count4/5

    32 tools is on the higher side, but given the comprehensive nature of Garmin data (many distinct metrics like HRV, SpO2, body battery, etc.), the count is justifiable for a read-only data retrieval server. Slight over-scoping but not excessive.

    Completeness5/5

    The server covers virtually all major Garmin data categories: activities (with detailed breakdowns), daily summaries, body metrics, sleep, heart rate, stress, training readiness, and more. No obvious gaps for a read-only interface.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides comprehensive access to Garmin Connect data including sleep analytics, health metrics, activities, and training volume analysis.
      16
      45 npm
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that exposes Garmin Connect health and activity data (steps, sleep, stress, activities, etc.) via tools for querying, analysis, and visualization.
      17
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for Garmin Connect that enables users to access and manage their personal health and fitness data, including daily summaries, heart rate, sleep, HRV, stress, body composition, activities, and training readiness, with secure per-user authentication.
      Functional Source , Version 1.1, ALv2 Future