Garmin Workouts

Provides Garmin Connect workout management via MCP—create, upload, schedule, list, and inspect workouts and activities.

typescript

10

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 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": {
    "st3v-garmin-workouts-mcp": {
      "command": "uvx",
      "args": [
        "garmin-workouts-mcp"
      ],
      "env": {
        "GARTH_HOME": "~/.garth",
        "GARMIN_EMAIL": "YOUR_EMAIL",
        "GARMIN_PASSWORD": "YOUR_PASSWORD"
      }
    }
  }
}

You can create, list, and manage Garmin Connect workouts directly from MCP-compatible clients using the Garmin Workouts MCP Server. It translates natural language prompts into Garmin-compatible workout data, lets you schedule and view activities, and keeps your workouts organized within Garmin Connect.

How to use

Connect to the Garmin Workouts MCP Server from any MCP-compatible client (for example, Claude Desktop). Use the server to generate, upload, schedule, and manage workouts, then inspect your activities and calendar in Garmin Connect.

How to install

Prerequisites: make sure you have the MCP runtime available in your environment. You will use a lightweight runtime tool to launch the MCP server and connect it to Garmin Connect.

uvx garmin-workouts-mcp

Configuration and authentication

Configure your MCP client to connect to the Garmin Workouts MCP Server. You will need to provide authentication details so the server can access Garmin Connect.

{
  "mcpServers": {
    "garmin_workouts": {
      "command": "uvx",
      "args": ["garmin-workouts-mcp"],
      "env": {
        "GARMIN_EMAIL": "your_email@example.com",
        "GARMIN_PASSWORD": "your_password"
      }
    }
  }
}

Environment and authentication details

The server authenticates with Garmin Connect using garth. You can provide credentials via environment variables or perform out-of-band authentication with garth and save tokens for reuse.

Environment variables you may use include GARMIN_EMAIL, GARMIN_PASSWORD, and GARTH_HOME for a custom token location.

Out-of-band authentication steps are optional if you prefer not to store credentials directly.

Available actions and tools

Access a set of MCP tools to generate, upload, schedule, and inspect Garmin workouts and activities. The core actions you can perform include creating workouts from natural language prompts, listing and detailing workouts, scheduling on specific dates, and retrieving activity data plus weather and calendar information.

Available tools

generate_workout_data_prompt

Generates a structured prompt for an LLM to produce Garmin workout data from a natural language description.

upload_workout

Uploads a structured workout to Garmin Connect using the generated workout data.

schedule_workout

Schedules a workout on a specified date within Garmin Connect and links it to the workout entry.

delete_workout

Removes a workout from Garmin Connect.

list_workouts

Lists all workouts currently stored in Garmin Connect.

get_workout

Retrieves detailed information about a specific workout by ID.

list_activities

Lists completed activities (runs, rides, swims, etc.) from Garmin Connect with optional filters.

get_activity

Retrieves detailed information for a specific activity.

get_activity_weather

Fetches weather conditions for the time and location of a specific activity.

get_calendar

Displays calendar data with workouts and activities for a given period.