# Garmin Personal MCP

> Garmin Personal MCP is an open-source MCP server for health and science. Read-only MCP server for asking AI about Garmin sleep, HRV, Body Battery and activities. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/mason-levyy/garmin-personal-mcp
- **MCP Registry name:** io.github.Mason-Levyy/garmin-personal-mcp
- **Categories:** health and science
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `garmin_download_activity`: Saves an activity file to the configured download folder.

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

- [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.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/garmin-personal-mcp
