# durely insights MCP for Garmin

> durely insights MCP for Garmin is an open-source MCP server for health and science. Analyse your full Garmin history locally through the official Personal API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Repository:** https://github.com/durely/garmin-insights-mcp
- **MCP Registry name:** app.durely/garmin-insights-mcp
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science)
- **Listing updated:** 2026-11-18

## About

This server keeps a local copy of your Garmin Connect history and lets an assistant answer questions about it, from a single run to years of training. It uses Garmin's Personal API with a key you create and can revoke, so no password or scraping is involved. The README calls it early development, so tools and options may change before 1.0, and says it is unofficial and not affiliated with Garmin.

The first question triggers a background sync; recent activities appear within seconds and the rest of the history follows in a few minutes, then data refreshes when it is over an hour old. Second-by-second detail comes from each activity's original FIT file, including laps, swim lengths, heart rate, power and cadence, plus VO2max, recovery time and lactate threshold when the device records them.

Built-in analysis covers time in zones, training load and fitness, fatigue and form, aerobic decoupling, best efforts, recovery trends and comparing similar sessions, and an assistant can run read-only SQL for anything else. It is read-only, and name, account ID and GPS positions stay out of answers unless you ask for a route. It needs Node.js 24 or later, or Docker.

## Features

- **Local history store:** Syncs your Garmin data once to a local database so trend questions answer quickly.
- **FIT-level detail:** Reads laps, swim lengths, heart rate, power and cadence from the original activity files.
- **Training analysis:** Time in zones, load, fitness and fatigue, decoupling and best efforts.
- **Health and recovery:** Sleep, HRV, resting heart rate and Body Battery questions.
- **Read-only SQL:** Assistants can run read-only queries over your data.
- **Privacy defaults:** Name, account ID and GPS positions are withheld unless a route is requested.

## Good for

- Review yesterday's run with splits and heart rate
- Compare the bike legs of two triathlons lap by lap
- See how sleep and HRV changed over a month
- Check whether a regular route is getting faster

## Install

### Claude Code (Terminal)

```sh
claude mcp add garmin-insights-mcp --env GARMIN_PERSONAL_API_KEY='<GARMIN_PERSONAL_API_KEY>' -- npx -y @durely/garmin-insights-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "garmin-insights-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@durely/garmin-insights-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "garmin-insights-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@durely/garmin-insights-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "garmin-insights-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@durely/garmin-insights-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "garmin-insights-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@durely/garmin-insights-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "garmin-insights-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@durely/garmin-insights-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I give it my Garmin password?

No. It uses a Personal API key you create in Garmin Connect, valid from 30 days to 1 year.

### Where is my data stored?

On your own machine; the README says your data stays local.

### Can it change my Garmin account?

No, it is read-only.

### How do I run it?

With npx using @durely/garmin-insights-mcp on Node.js 24 or later, or with the ghcr.io/durely/garmin-insights-mcp Docker image.

### Is durely insights MCP for Garmin free?

Yes. durely insights MCP for Garmin is open source, so you can use and self-host it for free.

### How do I add durely insights MCP for Garmin to Claude Code?

Run this command in your terminal: claude mcp add garmin-insights-mcp --env GARMIN_PERSONAL_API_KEY='<GARMIN_PERSONAL_API_KEY>' -- npx -y @durely/garmin-insights-mcp

### What are the best alternatives to durely insights MCP for Garmin?

The closest alternatives to durely insights MCP for Garmin 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.
- [Idigbio](https://ai-powered.com/mcp/idigbio): Idigbio is a freemium MCP server for health and science.
- [Ensembl](https://ai-powered.com/mcp/ensembl): Ensembl is a freemium MCP server for health and science.

---
Source: https://ai-powered.com/mcp/durely-insights-mcp-for-garmin
