Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

durely insights MCP for Garmin

✓ service owner · durely.app

by durelyversion 0.5.2i★ 2iRuns on your computerRepository ↗
Registry nameapp.durely/garmin-insights-mcp

How to install

What it does

Your full Garmin history, kept locally, analysed down to the second, via the official Personal API.

  • Connects Runs on your computer
  • Account or key Needs GARMIN_PERSONAL_API_KEY, GARMIN_API_KEY_EXPIRES
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity6/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score18/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install durely insights MCP for Garmin. Follow https://mcp.popnx.com/i/durely-garmin-insights-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a durely insights MCP for Garmin key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server durely insights MCP for Garmin for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "garmin-insights": { "command": "npx", "args": [ "-y", "@durely/garmin-insights-mcp" ], "env": { "GARMIN_PERSONAL_API_KEY": "your-value", "GARMIN_API_KEY_EXPIRES": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GARMIN_PERSONAL_API_KEY, GARMIN_API_KEY_EXPIRES, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the durely insights MCP for Garmin tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a durely insights MCP for Garmin key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the durely insights MCP for Garmin site ↗

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

    {
      "mcpServers": {
        "garmin-insights": {
          "command": "npx",
          "args": [
            "-y",
            "@durely/garmin-insights-mcp"
          ],
          "env": {
            "GARMIN_PERSONAL_API_KEY": "your-value",
            "GARMIN_API_KEY_EXPIRES": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Quit Claude and open it again

  6. Try it

    Use durely insights MCP for Garmin and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using durely insights MCP for Garmin or shows a durely insights MCP for Garmin tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GARMIN_MCP_TIMEZONE Your time zone, e.g. Europe/Brussels. Defaults to your computer's time zone.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect durely insights MCP for Garmin yet

durely insights MCP for Garmin runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect durely insights MCP for Garmin

  • You need a durely insights MCP for Garmin key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a durely insights MCP for Garmin key (create it on the maker’s site) · Install Node.js on your computer first (one time)
  • You need a durely insights MCP for Garmin key (create it on the maker’s site) · Install Node.js on your computer first (one time)
  • You need a durely insights MCP for Garmin key (create it on the maker’s site) · Install Node.js on your computer first (one time)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a durely insights MCP for Garmin key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server durely insights MCP for Garmin for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user garmin-insights --env GARMIN_PERSONAL_API_KEY=your-value --env GARMIN_API_KEY_EXPIRES=your-value -- npx -y @durely/garmin-insights-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GARMIN_PERSONAL_API_KEY, GARMIN_API_KEY_EXPIRES, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the durely insights MCP for Garmin tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a durely insights MCP for Garmin key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the durely insights MCP for Garmin site ↗

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press Enter

    claude mcp add --scope user garmin-insights --env GARMIN_PERSONAL_API_KEY=your-value --env GARMIN_API_KEY_EXPIRES=your-value -- npx -y @durely/garmin-insights-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Type /mcp in Claude Code

    You should see durely insights MCP for Garmin listed as connected

  6. Try it

    Use durely insights MCP for Garmin and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using durely insights MCP for Garmin or shows a durely insights MCP for Garmin tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GARMIN_MCP_TIMEZONE Your time zone, e.g. Europe/Brussels. Defaults to your computer's time zone.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a durely insights MCP for Garmin key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server durely insights MCP for Garmin for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "garmin-insights": { "command": "npx", "args": [ "-y", "@durely/garmin-insights-mcp" ], "env": { "GARMIN_PERSONAL_API_KEY": "your-value", "GARMIN_API_KEY_EXPIRES": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GARMIN_PERSONAL_API_KEY, GARMIN_API_KEY_EXPIRES, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the durely insights MCP for Garmin tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a durely insights MCP for Garmin key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the durely insights MCP for Garmin site ↗

  3. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  4. Fill in your key

    In the durely insights MCP for Garmin settings, GARMIN_PERSONAL_API_KEY, GARMIN_API_KEY_EXPIRES is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use durely insights MCP for Garmin and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using durely insights MCP for Garmin or shows a durely insights MCP for Garmin tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GARMIN_MCP_TIMEZONE Your time zone, e.g. Europe/Brussels. Defaults to your computer's time zone.

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a durely insights MCP for Garmin key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server durely insights MCP for Garmin for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "garmin-insights": { "type": "stdio", "command": "npx", "args": [ "-y", "@durely/garmin-insights-mcp" ], "env": { "GARMIN_PERSONAL_API_KEY": "your-value", "GARMIN_API_KEY_EXPIRES": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GARMIN_PERSONAL_API_KEY, GARMIN_API_KEY_EXPIRES, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the durely insights MCP for Garmin tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a durely insights MCP for Garmin key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the durely insights MCP for Garmin site ↗

  3. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  4. Fill in your key

    In the durely insights MCP for Garmin settings, GARMIN_PERSONAL_API_KEY, GARMIN_API_KEY_EXPIRES is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use durely insights MCP for Garmin and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using durely insights MCP for Garmin or shows a durely insights MCP for Garmin tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GARMIN_MCP_TIMEZONE Your time zone, e.g. Europe/Brussels. Defaults to your computer's time zone.

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use durely insights MCP for Garmin💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user garmin-insights --env GARMIN_PERSONAL_API_KEY=your-value --env GARMIN_API_KEY_EXPIRES=your-value -- npx -y @durely/garmin-insights-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "garmin-insights": {
      "command": "npx",
      "args": [
        "-y",
        "@durely/garmin-insights-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "your-value",
        "GARMIN_API_KEY_EXPIRES": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "garmin-insights": {
      "command": "npx",
      "args": [
        "-y",
        "@durely/garmin-insights-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "your-value",
        "GARMIN_API_KEY_EXPIRES": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "garmin-insights": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@durely/garmin-insights-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "your-value",
        "GARMIN_API_KEY_EXPIRES": "your-value"
      }
    }
  }
}

Values you fill in

  • GARMIN_PERSONAL_API_KEY secret required env
    Your Garmin Personal API key. Leave empty if you saved it with `npx -y @durely/garmin-insights-mcp auth` (recommended): the server then reads it from ~/.config/garmin/connect-personal-api-key.
  • GARMIN_MCP_TIMEZONE env
    Your time zone, e.g. Europe/Brussels. Defaults to your computer's time zone.
  • GARMIN_API_KEY_EXPIRES secret required env
    The date your key expires, e.g. 2027-10-24, so the server can warn you in time.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
125/wk
Verified domain
✓ durely.app
Licencei
Apache-2.0
Connection
Runs on your computer
Latest versioni
0.5.2
Categoryi
Other
Published to registryi
Oct 30, 2026
Code last changedi
Oct 30, 2026
Maker
durely
Packages
npm: @durely/garmin-insights-mcp
oci: ghcr.io/durely/garmin-insights-mcp:0.5.2
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain durely.app (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed 20 days ago

  • ✓ Pass

    Has a licence

    Uses Apache-2.0

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for @durely/garmin-insights-mcp@0.5.2

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/durely-garmin-insights-mcp.svg)](https://mcp.popnx.com/en/servers/durely-garmin-insights-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 91% of the other 20693 servers in this category
  • Published to the registry more recently than 68% of the other 20693 servers in this category
  • Basic checks equal to or better than 99% of the other 20693 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is durely insights MCP for Garmin safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: GARMIN_PERSONAL_API_KEY, GARMIN_API_KEY_EXPIRES

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 20 days ago, and the latest version (0.5.2) reached the registry 20 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js, Docker on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
durely insights MCP for Garmin
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/41/44/4
LicenseApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

durely garmin-insights-mcp

Ask your AI assistant about your own Garmin data: your full training history, health and recovery, analysed.

durely insights is an MCP server that connects your Garmin Connect account to your AI assistant (Claude, Cursor, GitHub Copilot, Gemini CLI, Codex or any other MCP client) through Garmin's official Personal API. It keeps a copy of your history on your own machine, so you can ask about a single run or about years of training and get an answer right away.

Early development. Everything below works, but tools and options can still change before version 1.0.

Unofficial project: not affiliated with or endorsed by Garmin.

What you can ask

Activities

  • "What did I do this week?" / "Show my last 10 runs"
  • "Tell me about yesterday's run": splits, heart rate, training effect, load
  • "How did my power and heart rate evolve over the intervals of Tuesday's ride?"
  • "Compare the bike legs of my last two triathlons lap by lap"
  • "Am I getting fitter on my regular Tuesday run?"

Training

  • "How has my training load and fitness developed over the last 3 months?"
  • "Analyse Saturday's ride: time in zones, decoupling, best efforts"
  • "How many kilometres did I run, ride and swim per year?"

Health and recovery

  • "How did I sleep this week, and how was my HRV?"
  • "Does a hard training day affect my HRV the next morning?"
  • "Compare my resting heart rate and sleep score per month this year"
  • "Show my heart rate and Body Battery through yesterday"

What makes it different

  • Official API, no password. It uses a Personal API key that you create in Garmin Connect and can revoke at any time. No scraping, nothing that breaks when Garmin changes its login.
  • Your whole history, instantly. Everything is synced once to a local database and kept up to date, so trend questions over months or years don't wait on Garmin.
  • Second-by-second detail. Laps, swim lengths, heart rate, power, cadence and more come from each activity's original FIT file, including VO2max, recovery time and lactate threshold when your device records them.
  • Analysis built in. Time in zones, training load and fitness/fatigue/form, aerobic decoupling, best efforts, recovery trends and comparisons of similar sessions. For anything else, your assistant can run read-only SQL over your data.
  • Private by default. Your data stays on your machine. Your name, account ID and GPS positions are kept out of answers unless you ask for a route.
  • Read-only. It can't change anything in your Garmin account.

Quick start

You need Garmin Connect, an MCP client (Claude Code, Claude Desktop, Cursor, …) and either Node.js 24+ or Docker.

1. Create your Personal API key
  1. In Garmin Connect on the web, open Settings → Personal API Token.
  2. Create a key and pick how long it stays valid (30 days to 1 year). Garmin shows it only once, so copy it.
  3. Save it by running this in your own terminal:
   npx -y @durely/garmin-insights-mcp auth

It asks for the key (your input stays hidden), checks it with Garmin and saves it to ~/.config/garmin/connect-personal-api-key, readable only by you. If Garmin rejects the key, nothing is saved. The server reads the key from this file, so it doesn't go in your client config.

With Docker (no Node.js), save it to that file yourself:

   mkdir -p ~/.config/garmin && chmod 700 ~/.config/garmin

pbpaste > ~/.config/garmin/connect-personal-api-key # macOS; elsewhere, paste it into this file with an editor chmod 600 ~/.config/garmin/connect-personal-api-key

Don't paste the key into a chat with your AI assistant.

2. Choose how to run it

With Node.js (npx): nothing to install. Your server command is:

npx -y @durely/garmin-insights-mcp

npx downloads the npm package on first use and picks up new releases by itself. Check your key with npx -y @durely/garmin-insights-mcp auth --check. Prefer a fixed install? npm install -g @durely/garmin-insights-mcp gives you the garmin-insights command.

Or with Docker (no Node.js needed; Docker must be running). Your server command is:

docker run -i --rm \

-v ~/.config/garmin/connect-personal-api-key:/run/secrets/garmin_api_key:ro \ -v garmin-mcp-data:/data \ -e GARMIN_MCP_TIMEZONE=Europe/Brussels \ ghcr.io/durely/garmin-insights-mcp

Replace Europe/Brussels with your own time zone. To check your key, run the same command with auth --check at the end. The image runs on Intel and ARM (Apple silicon, Raspberry Pi). More Docker tips are in How it works.

Or from source: clone the repo and build it with npm or Docker. See How it works.

Updating: with npx, restart your client. With Docker, run docker pull ghcr.io/durely/garmin-insights-mcp. Your synced data is kept.

3. Add it to your AI client

Claude Code:

claude mcp add garmin --scope user -- npx -y @durely/garmin-insights-mcp

With Docker:

claude mcp add garmin --scope user -- docker run -i --rm \

-v ~/.config/garmin/connect-personal-api-key:/run/secrets/garmin_api_key:ro \ -v garmin-mcp-data:/data \ -e GARMIN_MCP_TIMEZONE=Europe/Brussels \ ghcr.io/durely/garmin-insights-mcp

--scope user makes it available in all your projects.

Claude Desktop: open Settings → Developer → Edit Config, add this, and restart Claude Desktop:

{

"mcpServers": { "garmin": { "command": "/opt/homebrew/bin/npx", "args": ["-y", "@durely/garmin-insights-mcp"] } } }

Desktop apps don't see your shell's PATH, so use the full path to npx (find it with which npx). If the log then says node isn't found, add "env": { "PATH": "/opt/homebrew/bin:/usr/bin:/bin" }, with the folder from which node first.

Claude Desktop with Docker, Cursor, VS Code, Gemini CLI, Codex CLI

Claude Desktop with Docker:

{

"mcpServers": { "garmin": { "command": "/usr/local/bin/docker", "args": [ "run", "-i", "--rm", "-v", "/Users/you/.config/garmin/connect-personal-api-key:/run/secrets/garmin_api_key:ro", "-v", "garmin-mcp-data:/data", "-e", "GARMIN_MCP_TIMEZONE=Europe/Brussels", "ghcr.io/durely/garmin-insights-mcp" ] } } }

Use full paths here; ~ isn't expanded in JSON configs.

Cursor: the same JSON as Claude Desktop, in ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

VS Code (GitHub Copilot agent mode): in .vscode/mcp.json, or via the command palette → _MCP: Add Server_:

{

"servers": { "garmin": { "type": "stdio", "command": "npx", "args": ["-y", "@durely/garmin-insights-mcp"] } } }

Gemini CLI:

gemini mcp add garmin npx -- -y @durely/garmin-insights-mcp

OpenAI Codex CLI:

codex mcp add garmin -- npx -y @durely/garmin-insights-mcp

Others (Windsurf, Cline, Zed, …): look for "MCP servers" in their settings. Any client that supports stdio servers works.

4. Try it

Start a new session and ask: _"Check my Garmin connection."_ It should report connected.

The first question starts a sync in the background. Your activities are there within seconds; the rest of your history follows in a few minutes. After that, the data refreshes automatically when it's more than an hour old.

Good to know

  • Keep your key's expiry date in mind. Garmin's API doesn't tell the server when your key expires. Set GARMIN_API_KEY_EXPIRES (e.g. 2027-10-24) in your client config and garmin_status reminds you in time. With Docker, pass it to the container instead: add -e GARMIN_API_KEY_EXPIRES=2027-10-24 to the docker run arguments. Replacing the key file is enough; no restart is needed.
  • Sync at least every few months. Garmin deletes intraday detail (heart rate through the day, overnight HRV readings) after about 4–5 months. Whatever the server has synced stays in your local copy.
  • Desktop and CLI clients only, for now. The server runs on your own machine, so it doesn't work in claude.ai on the web or mobile yet.
  • Your data goes to your AI client. The server only talks to Garmin, but the answers it gives go to the MCP client and model you use.

Troubleshooting

ProblemFix
Tools don't show upStart a new session or restart the client. In Claude Code, check /mcp.
spawn npx ENOENT / server won't start (desktop apps)Use the full path to npx or docker in the config.
"No Garmin Personal API key configured"The key file is missing or not mounted. Check the path (and the -v mount for Docker).
"Garmin rejected the Personal API key"The key expired or was revoked. Create a new one and replace the file (or run auth again). auth --check tests it.
Dates are off by a daySet GARMIN_MCP_TIMEZONE to your time zone (especially in Docker). garmin_status warns when it differs from Garmin.
Want to see the tools without an AI clientnpx @modelcontextprotocol/inspector npx -y @durely/garmin-insights-mcp

Tools

You don't need to call these yourself; your assistant picks them. For reference:

ToolWhat it does
garmin_statusConnection check: key, token, time zone, key expiry
garmin_get_profileProfile settings, heart rate zones per sport, fitness age
garmin_list_activitiesSearch your activities by date, sport, name, distance or duration
garmin_get_activityOne activity in full: summary metrics, splits, structured workout
garmin_get_activity_lapsLaps from the FIT file: pace, HR, power, cadence, swim lengths, VO2max, recovery time
garmin_get_activity_streamsSecond-by-second HR, power, speed, cadence, altitude, …; zoom into any part

| garmin_analyze_activity | Time in zones, NP/IF/TSS, aerobic decoupling, best efforts, intervals

Only the beginning is shown; read the rest in the repo