Skip to content
MCP server

Garmin Personal MCP

Read-only MCP server for asking AI about Garmin sleep, HRV, Body Battery and activities

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
2 days ago

About Garmin Personal MCP

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

Unlike many Garmin servers, this one avoids your Garmin password. The README explains that most rely on an unofficial library that breaks when Garmin changes its login, whereas this uses the Personal API Garmin opened to individuals in October 2026. You create a revocable key in Garmin Connect, valid from 30 days to a year, and run garmin-personal-mcp auth once to save it with owner-only permissions.

Every working endpoint in Garmin's reference has a tool, with its documented filters. Date ranges longer than an endpoint allows, such as 28 days for steps or 31 for sleep, are split into several requests automatically, and all-day sample arrays are left out unless requested to keep responses model-sized. The README is clear that this is an unofficial project built on the official API, and that it is read-only.

It runs through uvx over stdio, or as an HTTP service from a published Docker image on port 8491. Set TZ in Docker so tools that default to today use your day.

Install

Run in a terminal

claude mcp add garmin-personal-mcp --env GARMIN_PERSONAL_API_KEY='<GARMIN_PERSONAL_API_KEY>' -- uvx garmin-personal-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": [
        "garmin-personal-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": [
        "garmin-personal-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "garmin-personal-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "garmin-personal-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": [
        "garmin-personal-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": [
        "garmin-personal-mcp"
      ],
      "env": {
        "GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
      }
    }
  }
}

Configuration

  • GARMIN_PERSONAL_API_KEYGarmin Connect Personal API key (optional; 'garmin-personal-mcp auth' saves one instead)
  • GARMIN_MCP_DOWNLOAD_DIRWhere garmin_download_activity saves activity files
  • GARMIN_PERSONAL_API_KEYGarmin Connect Personal API key, from Garmin Connect under Settings, Personal APIRequired

Tools this server provides (1)

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

garmin_download_activity
Saves an activity file to the configured download folder.

What it does

Official Personal API
Uses Garmin's documented API and a revocable key, not your password.
Full endpoint coverage
Every working endpoint in Garmin's reference has a tool with its filters.
Automatic range splitting
Long date ranges are broken into allowed request sizes.
Compact responses
All-day sample arrays are left out unless asked for.
Activity downloads
Activity files can be saved to a configured folder.
Docker option
A prebuilt image can run the server as an HTTP service.

Good for

  • Ask how you slept last night
  • Check whether HRV has been trending down this month
  • Compare your last three long runs
  • Review Body Battery, stress and training load
  • Download an activity file for analysis

Pricing

Open source

Free and open source; needs a Garmin Connect account

Garmin Personal MCP FAQ

Does it need my Garmin password?

No. It uses a Personal API key you create in Garmin Connect.

Can it change my Garmin data?

No. The Personal API is read-only and so is the server.

How long does a key last?

You choose from 30 days to a year, and Garmin emails about a week before expiry.

How do I install it?

Run uvx garmin-personal-mcp auth, then add the server to your client; uv is required.

Is it made by Garmin?

No. It is an unofficial project that talks to Garmin's official API.

Is Garmin Personal MCP free?

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

How do I add Garmin Personal MCP to Claude Code?

Run this command in your terminal: claude mcp add garmin-personal-mcp --env GARMIN_PERSONAL_API_KEY='<GARMIN_PERSONAL_API_KEY>' -- uvx garmin-personal-mcp

What are the best alternatives to Garmin Personal MCP?

The closest alternatives to Garmin Personal MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

Alternatives to Garmin Personal MCP

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science