Skip to main content
Glama
slaat

Garmin Connect Workouts MCP

by slaat
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

update_garmin_workout

Idempotent

Replace an existing Garmin workout's entire contents—name, sport, steps, pool settings—keeping its ID. Fetch the current workout first to avoid dropping omitted fields.

Instructions

Replace the entire contents (name, sport, steps, pool settings) of an existing workout, identified by workoutId, keeping its id. This is a full overwrite, not a partial patch - fields you omit are dropped. Call get_garmin_workout first to see the current contents before changing them. If no valid session exists, returns a message asking you to run authenticate_garmin rather than throwing.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameYesWorkout name, shown in Garmin Connect and on the device.
sportYesSport for this workout: running, cycling, or swimming. Governs which target types apply and whether stroke/equipment/poolLength are used.
stepsYesThe ordered list of steps and repeat blocks that make up the workout, in the order they should be performed.
workoutIdYesThe numeric Garmin workout id, as returned by create_garmin_workout or listed by list_garmin_workouts.
poolLengthNoSwimming only - pool length for this workout, e.g. 25. Only valid when sport is 'swimming'.
poolLengthUnitNoSwimming only - unit for poolLength. Defaults to 'm' when poolLength is given without a unit.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • changedInput schema / properties / name / description
      Previous value: -"Workout name."New value: +"Workout name, shown in Garmin Connect and on the device."
    • addedInput schema / properties / poolLength
      Added value: +{
+  "description": "Swimming only - pool length for this workout, e.g. 25. Only valid when sport is 'swimming'.",
+  "exclusiveMinimum": 0,
+  "type": "number"
+}
    • addedInput schema / properties / poolLengthUnit
      Added value: +{
+  "description": "Swimming only - unit for poolLength. Defaults to 'm' when poolLength is given without a unit.",
+  "enum": [
+    "m",
+    "yd"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / sport / description
      Added value: +"Sport for this workout: running, cycling, or swimming. Governs which target types apply and whether stroke/equipment/poolLength are used."
    • changedInput schema / properties / steps / description
      Previous value: -"The ordered list of steps and repeat blocks that make up the workout."New value: +"The ordered list of steps and repeat blocks that make up the workout, in the order they should be performed."
    • changedInput schema / properties / steps / items / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "duration": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "time",
-                "type": "string"
-              },
-              "unit": {
-                "enum": [
-                  "sec",
-                  "min",
-                  "hour"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "description": "e.g. 10",
-                "type": "number"
-              }
-            },
-            "required": [
-              "type",
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "distance",
-                "type": "string"
-              },
-              "unit": {
-                "enum": [
-                  "m",
-                  "km",
-                  "mi"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "description": "e.g. 1.5",
-                "type": "number"
-              }
-            },
-            "required": [
-              "type",
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "lapButton",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "calories",
-                "type": "string"
-              },
-              "value": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "type",
-              "value"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "description": "End when heart rate crosses a threshold, e.g. warm up until HR > 130.",
-            "properties": {
-              "bpm": {
-                "type": "number"
-              },
-              "compare": {
-                "description": "End when HR is below (lt) or above (gt) bpm.",
-                "enum": [
-                  "lt",
-                  "gt"
-                ],
-                "type": "string"
-              },
-              "type": {
-                "const": "heartRate",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "bpm",
-              "compare"
-            ],
-            "type": "object"
-          }
-        ],
-        "description": "How the step ends."
-      },
-      "intensity": {
-        "enum": [
-          "warmup",
-          "active",
-          "rest",
-          "cooldown"
-        ],
-        "type": "string"
-      },
-      "kind": {
-        "const": "step",
-        "type": "string"
-      },
-      "name": {
-        "description": "Shown on the watch, e.g. 'Threshold 1'.",
-        "type": "string"
-      },
-      "notes": {
-        "description": "Free-text note shown on the watch.",
-        "type": "string"
-      },
-      "target": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "none",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "description": "Zone 1 recovery, 2 aerobic/base, 3 tempo, 4 threshold, 5 VO2max.",
-            "properties": {
-              "type": {
-                "const": "hrZone",
-                "type": "string"
-              },
-              "zone": {
-                "maximum": 5,
-                "minimum": 1,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "type",
-              "zone"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "description": "Explicit heart rate range in bpm.",
-            "properties": {
-              "high": {
-                "type": "number"
-              },
-              "low": {
-                "type": "number"
-              },
-              "type": {
-                "const": "hrBpm",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "low",
-              "high"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "description": "Pace range. `fast` is the quicker bound. A single pace is widened by 10 s.",
-            "properties": {
-              "fast": {
-                "description": "M:SS, e.g. '4:00'",
-                "type": "string"
-              },
-              "slow": {
-                "description": "M:SS. Optional - if omitted, 10 s/unit slower than `fast` is used.",
-                "type": "string"
-              },
-              "type": {
-                "const": "pace",
-                "type": "string"
-              },
-              "unit": {
-                "enum": [
-                  "min/km",
-                  "min/mi"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "fast",
-              "unit"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "description": "Cycling power in watts.",
-            "properties": {
-              "high": {
-                "type": "number"
-              },
-              "low": {
-                "type": "number"
-              },
-              "type": {
-                "const": "power",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "low",
-              "high"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "description": "Cadence range (rpm / spm).",
-            "properties": {
-              "high": {
-                "type": "number"
-              },
-              "low": {
-                "type": "number"
-              },
-              "type": {
-                "const": "cadence",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "low",
-              "high"
-            ],
-            "type": "object"
-          }
-        ],
-        "description": "Intensity target for the step. Omit or use {type:'none'} for no target."
-      }
-    },
-    "required": [
-      "kind",
-      "intensity",
-      "duration"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "description": "A real interval block. Prefer this over repeating steps by hand - the watch then shows a rep counter.",
-    "properties": {
-      "iterations": {
-        "minimum": 2,
-        "type": "integer"
-      },
-      "kind": {
-        "const": "repeat",
-        "type": "string"
-      },
-      "steps": {
-        "description": "Steps repeated as a block, e.g. an interval plus its recovery.",
-        "items": {
-          "$ref": "#/properties/steps/items"
-        },
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "kind",
-      "iterations",
-      "steps"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "duration": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "time",
+                "type": "string"
+              },
+              "unit": {
+                "enum": [
+                  "sec",
+                  "min",
+                  "hour"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "description": "e.g. 10",
+                "type": "number"
+              }
+            },
+            "required": [
+              "type",
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "distance",
+                "type": "string"
+              },
+              "unit": {
+                "enum": [
+                  "m",
+                  "km",
+                  "mi"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "description": "e.g. 1.5",
+                "type": "number"
+              }
+            },
+            "required": [
+              "type",
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "lapButton",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "calories",
+                "type": "string"
+              },
+              "value": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "type",
+              "value"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "description": "End when heart rate crosses a threshold, e.g. warm up until HR > 130.",
+            "properties": {
+              "bpm": {
+                "type": "number"
+              },
+              "compare": {
+                "description": "End when HR is below (lt) or above (gt) bpm.",
+                "enum": [
+                  "lt",
+                  "gt"
+                ],
+                "type": "string"
+              },
+              "type": {
+                "const": "heartRate",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "bpm",
+              "compare"
+            ],
+            "type": "object"
+          }
+        ],
+        "description": "How the step ends."
+      },
+      "equipment": {
+        "description": "Swimming only - equipment used for this step (fins, kickboard, paddles, pull_buoy, snorkel). Only valid when the workout's sport is 'swimming'.",
+        "enum": [
+          "fins",
+          "kickboard",
+          "paddles",
+          "pull_buoy",
+          "snorkel"
+        ],
+        "type": "string"
+      },
+      "intensity": {
+        "enum": [
+          "warmup",
+          "active",
+          "rest",
+          "cooldown"
+        ],
+        "type": "string"
+      },
+      "kind": {
+        "const": "step",
+        "type": "string"
+      },
+      "name": {
+        "description": "Shown on the watch, e.g. 'Threshold 1'.",
+        "type": "string"
+      },
+      "notes": {
+        "description": "Free-text note shown on the watch.",
+        "type": "string"
+      },
+      "stroke": {
+        "description": "Swimming only - the stroke for this step. 'any' = any stroke, 'im' = individual medley. Only valid when the workout's sport is 'swimming'.",
+        "enum": [
+          "any",
+          "backstroke",
+          "breaststroke",
+          "drill",
+          "fly",
+          "free",
+          "im"
+        ],
+        "type": "string"
+      },
+      "target": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "none",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "description": "Zone 1 recovery, 2 aerobic/base, 3 tempo, 4 threshold, 5 VO2max.",
+            "properties": {
+              "type": {
+                "const": "hrZone",
+                "type": "string"
+              },
+              "zone": {
+                "maximum": 5,
+                "minimum": 1,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "zone"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "description": "Explicit heart rate range in bpm.",
+            "properties": {
+              "high": {
+                "type": "number"
+              },
+              "low": {
+                "type": "number"
+              },
+              "type": {
+                "const": "hrBpm",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "low",
+              "high"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "description": "Pace range. `fast` is the quicker bound. A single pace is widened by 10 s.",
+            "properties": {
+              "fast": {
+                "description": "M:SS, e.g. '4:00'",
+                "type": "string"
+              },
+              "slow": {
+                "description": "M:SS. Optional - if omitted, 10 s/unit slower than `fast` is used.",
+                "type": "string"
+              },
+              "type": {
+                "const": "pace",
+                "type": "string"
+              },
+              "unit": {
+                "enum": [
+                  "min/km",
+                  "min/mi"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "fast",
+              "unit"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "description": "Cycling power in watts.",
+            "properties": {
+              "high": {
+                "type": "number"
+              },
+              "low": {
+                "type": "number"
+              },
+              "type": {
+                "const": "power",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "low",
+              "high"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "description": "Cadence range (rpm / spm).",
+            "properties": {
+              "high": {
+                "type": "number"
+              },
+              "low": {
+                "type": "number"
+              },
+              "type": {
+                "const": "cadence",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "low",
+              "high"
+            ],
+            "type": "object"
+          }
+        ],
+        "description": "Intensity target for the step. Omit or use {type:'none'} for no target."
+      }
+    },
+    "required": [
+      "kind",
+      "intensity",
+      "duration"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "A real interval block. Prefer this over repeating steps by hand - the watch then shows a rep counter.",
+    "properties": {
+      "iterations": {
+        "minimum": 2,
+        "type": "integer"
+      },
+      "kind": {
+        "const": "repeat",
+        "type": "string"
+      },
+      "steps": {
+        "description": "Steps repeated as a block, e.g. an interval plus its recovery.",
+        "items": {
+          "$ref": "#/properties/steps/items"
+        },
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "kind",
+      "iterations",
+      "steps"
+    ],
+    "type": "object"
+  }
+]
    • changedInput schema / properties / workoutId / description
      Previous value: -"The Garmin workout id."New value: +"The numeric Garmin workout id, as returned by create_garmin_workout or listed by list_garmin_workouts."
  2. First observedv1.0.0

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses several behavioral traits beyond the annotations: this is a full overwrite, fields omitted are dropped, the workout id is preserved, and invalid sessions produce an authentication-prompt message rather than an exception. These details are not conveyed by the annotations or schema. There is no contradiction with the idempotentHInt.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, no filler. The core action and overwrite semantics are front-loaded, followed by the critical warning and the auth-failure behavior. Every sentence carries useful information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is strong given the rich input schema and workflow guidance. It covers overwrite semantics, the need to fetch first, and authentication failure behavior. Minor gaps remain: it does not describe what a successful update returns, and it does not say what happens if the workoutId does not exist. These are not fatal, but they leave some ambiguity for an agent without an output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly. The description adds the important semantic that omitted fields are dropped, which affects how optional parameters like poolLength and poolLengthUnit are interpreted. Otherwise it does not add much per-parameter meaning beyond the schema's own descriptions, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'Replace the entire contents ... of an existing workout, identified by workoutId, keeping its id.' It clearly distinguishes this from create_garmin_workout by emphasizing full overwrite on an existing workout and explicitly says it is not a partial patch. An agent can immediately tell this tool from its siblings without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides clear context and a concrete prerequisite: 'Call get_garmin_workout first to see the current contents before changing them.' It also warns that omitted fields are dropped, telling the agent to include all desired fields. It does not explicitly name create_garmin_workout as the alternative for new workouts, but the 'existing workout' language makes the intended use apparent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools