Garmin

Provides Garmin Connect activity data, insights, and health-based training guidance via MCP.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "j4sun-garmin-mcp": {
      "command": "node",
      "args": [
        "path/to/garmin-mcp/dist/index.js"
      ],
      "env": {
        "GARMIN_PASSWORD": "YOUR_GARMIN_PASSWORD",
        "GARMIN_USERNAME": "YOUR_GARMIN_USERNAME",
        "GARMIN_AUTO_AUTH": "true"
      }
    }
  }
}

This MCP server lets Garmin Connect users access activity data, health metrics, insights, and AI-powered training suggestions directly from your Claude Desktop setup. It runs locally and processes data securely on your machine, giving you actionable coaching based on your Garmin data.

How to use

You interact with the Garmin MCP Server through your MCP client to authenticate with Garmin Connect, fetch activities, view insights, and receive training guidance. Start by authenticating, then pull recent activities, analyze them, and request personalized training suggestions. When you request health metrics, you’ll see heart rate, sleep, stress, and body battery data. All processing happens locally on your device, and credentials are kept in memory for the current session.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

# 1) Clone or download the MCP server
# 2) Install dependencies
cd garmin-mcp
npm install

# 3) Build the TypeScript code
npm run build

# 4) Run the server (after build, point to the built index)
node path/to/garmin-mcp/dist/index.js

Configuration and usage notes

Environment variables help you keep credentials out of source control and automate authentication on startup.

# .env
GARMIN_USERNAME=your.email@example.com
GARMIN_PASSWORD=your_secure_password
GARMIN_AUTO_AUTH=true

Claude Desktop setup

Add the MCP server to your Claude Desktop configuration so you can access Garmin data from your conversations.

{
  "mcpServers": {
    "garmin": {
      "command": "node",
      "args": ["path/to/garmin-mcp/dist/index.js"]
    }
  }
}

Available tools

authenticate_garmin

Authenticate with Garmin Connect using your credentials to establish a session for subsequent MCP commands.

get_activities

Retrieve recent activities from Garmin Connect, with optional lookback days and limit.

get_activity_insights

Get detailed insights for a specific activity or a set of recent activities.

get_training_suggestions

Obtain AI-powered training recommendations based on recent workouts and performance data.

get_health_metrics

Fetch health and wellness metrics such as heart rate, sleep, stress, and body battery.