# durely insights MCP for Garmin

The durely insights MCP for Garmin MCP server for Claude Code connects Garmin Connect via official Personal API tokens to inspect training history, recovery, and sleep locally.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: durely
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/durely/garmin-insights-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/durely-insights-mcp-for-garmin

## What it does

This tool syncs your Garmin Connect activity logs straight into a local database on your machine. It extracts second-by-second telemetry from original FIT files, covering heart rate, power output, cadence, lap markers, VO2max, and estimated recovery times. Operating strictly in read-only mode, it keeps user IDs and GPS coordinates out of model prompts by default.

Built-in routines evaluate training load, fitness-fatigue trends, and aerobic decoupling across workouts. When standard reporting is insufficient, your assistant runs read-only SQL queries directly against your local records.

You need Node.js 24+ or Docker on your system. Because authentication relies on a personal key with a 30-day to 1-year lifespan, your account password remains completely unexposed.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GARMIN_PERSONAL_API_KEY`, `GARMIN_MCP_TIMEZONE`, `GARMIN_API_KEY_EXPIRES` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> --env GARMIN_MCP_TIMEZONE=<GARMIN_MCP_TIMEZONE> --env GARMIN_API_KEY_EXPIRES=<GARMIN_API_KEY_EXPIRES> --transport stdio durely-insights-mcp-for-garmin -- npx -y @durely/garmin-insights-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add durely-insights-mcp-for-garmin --env GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> --env GARMIN_MCP_TIMEZONE=<GARMIN_MCP_TIMEZONE> --env GARMIN_API_KEY_EXPIRES=<GARMIN_API_KEY_EXPIRES> -- npx -y @durely/garmin-insights-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "durely-insights-mcp-for-garmin": {
            "command": "npx",
            "args": [
                "-y",
                "@durely/garmin-insights-mcp"
            ],
            "env": {
                "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>",
                "GARMIN_MCP_TIMEZONE": "<GARMIN_MCP_TIMEZONE>",
                "GARMIN_API_KEY_EXPIRES": "<GARMIN_API_KEY_EXPIRES>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "durely-insights-mcp-for-garmin": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@durely/garmin-insights-mcp"
            ],
            "env": {
                "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>",
                "GARMIN_MCP_TIMEZONE": "<GARMIN_MCP_TIMEZONE>",
                "GARMIN_API_KEY_EXPIRES": "<GARMIN_API_KEY_EXPIRES>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> -e GARMIN_MCP_TIMEZONE=<GARMIN_MCP_TIMEZONE> -e GARMIN_API_KEY_EXPIRES=<GARMIN_API_KEY_EXPIRES> durely-insights-mcp-for-garmin npx -y @durely/garmin-insights-mcp
```
Replace <…> with your own values

## When to use it
- evaluate power distribution across interval sessions
- monitor nocturnal HRV and recovery scores over months
- compare specific lap times between past race efforts
- tally annual mileage across running, swimming, and cycling

## Example prompts
- Compare bike splits between my last two triathlons
- Show Body Battery and heart rate readings from yesterday
- How many kilometres did I log across running and cycling last year?

## Similar
- [Garmin Connect](https://affpapa.org/en/nevibecode/mcp/garmin-connect.md) — MCP server · ★ 76 repo stars
- [kaiord](https://affpapa.org/en/nevibecode/mcp/kaiord.md) — MCP server · ★ 12 repo stars
- [garmin-local-mcp](https://affpapa.org/en/nevibecode/mcp/garmin-local-mcp.md) — MCP server · ★ 9 repo stars
- [athletedata](https://affpapa.org/en/nevibecode/mcp/athletedata.md) — MCP server · ★ 3 repo stars
- [Garmin Connect (treinos)](https://affpapa.org/en/nevibecode/mcp/garmin-connect-treinos.md) — MCP server · 264 installs
- [chirona](https://affpapa.org/en/nevibecode/mcp/chirona.md) — MCP server · 129 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
