Skip to main content
Glama
Garmin MCP Server

Garmin MCP Server

by nitinmms

Garmin MCP Server

A read-only MCP server that lets an AI agent query your own Garmin Connect data through Garmin's official Personal API.

1. Create a personal API key

  1. Sign in to Garmin Connect Web and open https://connect.garmin.com/app/settings/personalApiToken.

  2. Create Key, accept the terms, pick an expiry (30 days – 1 year), and copy the key. It is shown only once — treat it like a password.

The server exchanges the key for a 24-hour access token and renews it automatically. When the key itself expires (Garmin emails you a week ahead), create a new one and update your config.

Related MCP server: Garmin MCP Worker

2. Install and verify

Requires uv and Python 3.11+.

cd c:\temp\garmin-mcp-server
uv sync

Check the key works (prints only field counts, no personal data):

$env:GARMIN_PERSONAL_API_KEY = "<your key>"; uv run garmin-mcp check

3. Connect an MCP client

Claude Code

claude mcp add garmin --scope user -e GARMIN_PERSONAL_API_KEY=<your key> -- uv --directory c:\temp\garmin-mcp-server run garmin-mcp

Then run /mcp in Claude Code to confirm garmin is connected.

Any other MCP client (stdio)

Most clients accept a JSON server entry like this:

{
  "mcpServers": {
    "garmin": {
      "command": "uv",
      "args": ["--directory", "c:\\temp\\garmin-mcp-server", "run", "garmin-mcp"],
      "env": { "GARMIN_PERSONAL_API_KEY": "<your key>" }
    }
  }
}

Tools

All tools are read-only. Dates are YYYY-MM-DD; a missing date means today. Ranged tools accept up to 366 days and split requests to fit Garmin's per-call limits (28/31 days). Tools marked † drop large intraday time series unless called with include_samples=true.

Area

Tools

Activities

search_activities, get_activity, get_activity_workouts

Daily health

get_daily_summary, get_daily_summaries, get_steps, get_stress, get_heart_rate†, get_body_battery†, get_spo2†, get_hydration, get_wellness_activities

Sleep & recovery

get_sleep, get_sleep_summaries, get_hrv†, get_hrv_range, get_fitness_age

Body & profile

get_weight, get_weight_goals, get_heart_rate_zones, get_profile_settings

Not available in the Personal API (so not offered here): training readiness, training status, VO2 max, personal records, and device lists.

Sample .NET MAUI app (Android)

app/GarminCoach is a Blazor Hybrid MAUI app that embeds this MCP server and coaches you: it reads the last 7 days of your own Garmin data through the read-only tools, shows every tool call it made, asks your chosen AI model for one cycling session, and sanity-checks the answer. Its shared coach core ships as the app/GarminCoach.Core library.

uv sync                                   # Python server + its HTTP extra
dotnet build garmin-mcp-server.slnx       # the app, its core and the .NET tests
dotnet test app/GarminCoach.Core.Tests    # the .NET unit tests

In the app, open Settings, paste your Garmin personal API key and your OpenAI or Anthropic key, then tap What should I ride today?. The app talks to the MCP server over the Streamable HTTP transport (garmin-mcp http); on the Android emulator it reaches this machine at http://10.0.2.2:8000. Point it at another address in Settings if your server runs elsewhere.

React Native Android app

app/ReactNativeCoach is a React Native (bare CLI, TypeScript) version of the same coach for Android. It reads the last 7 days through the read-only tools, shows every tool call, and asks your chosen AI model for one cycling session. See app/ReactNativeCoach/README.md for starting the server in HTTP mode, running the app on an emulator, and pointing it at a server on another host.

cd app/ReactNativeCoach
npm ci
npm run typecheck
npm run test:ci          # writes test-results/junit.xml and coverage/cobertura-coverage.xml
npm run android          # with an Android emulator running

Android deploys with "not enough space"

If deployment to the emulator stops with

ADB0010: Mono.AndroidTools.InstallFailedException: ... Requested internal only, but not enough space

the emulator's internal data partition is too small for a MAUI debug build, and Android's default is to install to internal storage only. app/GarminCoach/GarminCoach.csproj sets AndroidInstallLocation to auto, which lets the system fall back to external storage. If it still fails, free space in the emulator with adb shell pm uninstall com.garmincoach.sample, or recreate the AVD with a larger internal storage (Device Manager -> Wipe Data / edit disk size).

Security notes

  • The key is read only from the GARMIN_PERSONAL_API_KEY environment variable and is never logged or included in error messages.

  • Revoke access at any time by deleting the key on Garmin Connect Web.

  • The Personal API is licensed for personal use with your own data only.

Development

uv run pytest

License

Licensed under the Apache License 2.0.

Available Tools

21 tools
get_activityB
Read-only

Get one activity's summary, metadata, measurements and split summaries.

Inputs: activity_id (required).

get_activity_workoutsC
Read-only

Get the structured workouts performed during an activity.

Inputs: activity_id (required).

get_body_batteryB
Read-only

Get daily Body Battery reports (charged, drained, events) for a date range.

Set include_samples=true for the intraday Body Battery values (large).

Inputs: start_date (required), end_date, include_samples.

get_daily_summariesA
Read-only

Get daily wellness summaries for a date range (up to a year). Best for trends across many days.

Inputs: start_date (required), end_date.

get_daily_summaryB
Read-only

Get one day's wellness summary: steps, calories, stress, Body Battery, intensity minutes, resting HR.

Inputs: date.

get_fitness_ageB
Read-only

Get the latest Fitness Age as of a date, with the factors that drive it.

Inputs: date.

get_heart_rateA
Read-only

Get one day's heart rate: resting, min, max, 7-day resting average.

Set include_samples=true for the intraday heart rate time series (large).

Inputs: date, include_samples.

get_heart_rate_zonesB
Read-only

Get the user's configured heart rate zones per sport.

Inputs: no named parameters.

get_hrvA
Read-only

Get one night's heart rate variability (HRV) summary and status.

Set include_samples=true for the individual overnight HRV readings.

Inputs: date, include_samples.

get_hrv_rangeB
Read-only

Get daily HRV summaries for a date range. Best for HRV trends.

Inputs: start_date (required), end_date.

get_hydrationB
Read-only

Get daily hydration intake and goals for a date range.

Inputs: start_date (required), end_date.

get_profile_settingsA
Read-only

Get profile settings: units, time zone, height, birth date, activity level, etc.

Inputs: no named parameters.

get_sleepB
Read-only

Get one night's sleep: duration, stages, sleep score, SpO2, respiration, sleep stress.

date is the calendar day the sleep ended on (the morning you woke up).

Inputs: date.

get_sleep_summariesA
Read-only

Get nightly sleep summaries for a date range. Best for sleep trends.

Inputs: start_date (required), end_date.

get_spo2A
Read-only

Get one day's blood oxygen (SpO2): average, lowest, sleep average, 7-day average.

Set include_samples=true for individual and hourly readings (large).

Inputs: date, include_samples.

get_stepsC
Read-only

Get daily step totals and step goals for a date range.

Inputs: start_date (required), end_date.

get_stressC
Read-only

Get daily stress levels for a date range.

Inputs: start_date (required), end_date.

get_weightA
Read-only

Get weight and body composition for a date range: daily latest weights and range average.

Weights are in grams.

Inputs: start_date (required), end_date.

get_weight_goalsC
Read-only

Get the weight goals in effect over a date range.

Inputs: start_date (required), end_date.

get_wellness_activitiesC
Read-only

Get wellness activity summaries (e.g. auto-detected moves) for a date range.

Inputs: start_date (required), end_date.

search_activitiesB
Read-only

Search recorded activities (runs, rides, swims, strength, ...), newest first.

Args: start_date: Earliest activity date, YYYY-MM-DD. end_date: Latest activity date, YYYY-MM-DD. activity_type: Garmin activity type key, e.g. "running", "cycling", "lap_swimming". search: Free-text match on activity name. limit: Page size (1-100). start: Offset for pagination.

Inputs: limit, start, search, end_date, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools target clearly distinct Garmin data domains and actions, such as activities, sleep, HRV, weight, and profile settings. The main ambiguity comes from singular/range pairs like get_daily_summary vs. get_daily_summaries and get_sleep vs. get_sleep_summaries, though the descriptions clarify their intended use.

    Naming Consistency4/5

    The tool set is overwhelmingly consistent snake_case and mostly follows a get_<resource> pattern, with search_activities as the main verb deviation. Singular/plural naming variants like summary/summaries and range-specific suffixes are readable but slightly inconsistent.

    Tool Count4/5

    At 21 tools, the surface is somewhat large but reflects the broad Garmin wellness and activity domain. Each metric group is reasonably scoped, though some singular/range pairs could potentially be consolidated.

    Completeness4/5

    The server covers a wide range of read-only Garmin data: activities, workouts, daily wellness, sleep, HRV, SpO2, hydration, weight, and profile settings. Some secondary areas such as devices, training status, VO2 max, or personal records are absent, but core health and activity workflows are well covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP-capable AI apps to query a user's own Garmin sleep, HRV, stress, Body Battery, heart-rate, activity, and body-metric data through Garmin's official Personal API in a read-only, locally run setup.
      14
      87 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      A read-only remote MCP server that lets Claude query your own Garmin Connect wellness and activity data — sleep, HRV, Body Battery, stress, heart rate, daily summaries, and workout details — through Garmin's official Personal API, with OAuth sign-in so it works from mobile and desktop clients.
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      This server provides a read-only remote connection between MCP clients and a Garmin Connect account. It allows users to query extensive personal health and activity data using natural language.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A read-only MCP server that lets AI assistants query a user's own training, recovery, sleep, activity, and wellness data through the official Garmin Connect Personal API. It can run locally or be self-hosted on Cloudflare Workers for access from Claude and other MCP clients.
      27
      575 npm
      MIT