# Garmin Connect

> Garmin Connect is an MCP server for health and science. Read and write Garmin Connect activities, health data, workouts and weigh-ins. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/happyc0der/garmin-connect-api
- **MCP Registry name:** io.github.happyc0der/garmin-connect-api
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science), [sports data](https://ai-powered.com/categories/sports-data)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [BasalFit](https://ai-powered.com/mcp/basalfit): BasalFit is a free MCP server for health and science.
- [Ebi Ols](https://ai-powered.com/mcp/ebi-ols): Ebi Ols is a freemium MCP server for health and science.
- [Clinicaltables](https://ai-powered.com/mcp/clinicaltables): Clinicaltables is a freemium MCP server for health and science.
- [Complex Portal](https://ai-powered.com/mcp/complex-portal): Complex Portal is a freemium MCP server for health and science.
- [Reaction Time Test MCP](https://ai-powered.com/mcp/reaction-time-test-mcp): Reaction Time Test MCP is a free MCP server for games and play.
- [Strava MCP](https://ai-powered.com/mcp/strava-mcp-3): Strava MCP is an open-source MCP server for sports data.

---
Source: https://ai-powered.com/mcp/garmin-connect-2
