Skip to content
MCP server

Garmin Connect

Read and write Garmin Connect activities, health data, workouts and weigh-ins

Runs locallyStatus and history
Install
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.2
Listing updated
today

Similar MCP servers

About Garmin Connect

Garmin Connect is an MCP server for health and science. It runs locally on your machine and is started by your AI client.

This unofficial server lets an assistant answer questions about your own Garmin data, such as how you slept this week, whether swim pace held up, or how resting heart rate moved since summer. It also writes: planned strength, run, ride and swim workouts, completed strength sessions with every set encoded as a FIT file, set corrections, and weigh-ins with full body composition.

The README counts 38 tools, annotated so a client can tell the 24 that only read from the 8 that add and the 6 that delete or overwrite. A catalogue of 1,527 Garmin exercises is bundled for offline lookup, and exercise names are checked before writes with suggested near misses.

There are cautions. It uses the same private endpoints as the Garmin Connect website through python-garminconnect, which Garmin's terms do not sanction, and endpoints can change. Uploaded sessions may sync to Strava, and repeated failed logins can lock an account. Log in once in a terminal with garmin login.

Install

Run in a terminal

claude mcp add garmin-connect-api -- uvx garmin-connect-api

Add to claude_desktop_config.json

{
  "mcpServers": {
    "garmin-connect-api": {
      "command": "uvx",
      "args": [
        "garmin-connect-api"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "garmin-connect-api": {
      "command": "uvx",
      "args": [
        "garmin-connect-api"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "garmin-connect-api": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "garmin-connect-api"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "garmin-connect-api": {
      "command": "uvx",
      "args": [
        "garmin-connect-api"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "garmin-connect-api": {
      "command": "uvx",
      "args": [
        "garmin-connect-api"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GARMINTOKENSDirectory holding the tokens `garmin login` writes. Defaults to ~/.garmin-api/default.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

garmin_status
Checks the login without calling Garmin.
find_exercise
Finds Garmin's name for a lift.
recent_strength_sessions
Recent strength sessions with sets.
week_summary
Summary of a week of training and health.
get_activity_laps
Laps for runs and rides, pace per 100 for swims.
get_trend
Rolls a metric over a long range into periods.

What it does

Activity detail
Per-set strength data, laps and pool-swim pace.
Daily health
Steps, heart rate, stress, body battery, sleep, HRV and readiness in one answer.
Trends
Twelve metrics rolled up daily, weekly or monthly over up to two years.
Workout creation
Create and schedule strength, run, ride and swim workouts.
Session logging
Log completed strength sessions and correct sets.
Body composition
Record weigh-ins with fat, water, muscle and more.

Good for

  • Review a week of sleep and recovery data
  • Check pace consistency across a swim
  • Plan a swim workout on your Garmin calendar
  • Log a gym session with every set
  • Track resting heart rate over months

Garmin Connect FAQ

Is it official?

No. It is unofficial and not affiliated with Garmin.

How do I sign in?

Run garmin login once in a terminal; the password is only typed there.

Can it delete things?

Yes, six tools delete or overwrite, and clients can ask before running them.

What does it require?

uv and Python 3.12 or newer.

How do I add Garmin Connect to Claude Code?

Run this command in your terminal: claude mcp add garmin-connect-api -- uvx garmin-connect-api

What are the best alternatives to Garmin Connect?

The closest alternatives to Garmin Connect are Tooluniverse, Oya Browser, BasalFit, Ebi Ols and Clinicaltables.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers