garmin-owl

Overview Schema Source Related Servers Discussions Admin

get_recent_activities

Read-only

List Garmin activity summaries from the last 1–90 days, ending today, and optionally filter by activity type or cap results.

Instructions

List activity summaries from the last 1-90 days ending today, optionally filtered by activity type.

Use for recent runs/rides; use get_activities for explicit calendar dates or get_activity for detail by ID. Filtering precedes the result limit. Returns the same envelope as get_activities, including truncated when more activities matched than limit. start_time is ISO 8601 with an explicit UTC offset and already local.

Requires saved local Garmin authentication (garmin-owl-auth). Reads Garmin and may update the local cache; never changes your Garmin account. Garmin failures are not retried automatically.

Input Schema

Name	Required	Description
`days`	No	Number of days from 1 to 90, ending today inclusive; defaults to 14.
`limit`	No	Maximum number of activities returned, from 1 to 100; defaults to 20. This is a result cap, not a page number.
`activity_type`	No	Optional exact Garmin activity type, matched case-insensitively, e.g. running or cycling. Omit for all types; blank strings are invalid.

Output Schema

Name	Required	Description
`count`	Yes	Number of activities returned.
`limit`	Yes
`order`	No
`offset`	No
`matched`	No	Activities in the range that passed every filter.
`end_date`	Yes
`truncated`	Yes	True when more activities matched than this response holds; pass next_offset as offset to get the rest.
`activities`	No
`start_date`	Yes
`next_offset`	No	offset for the next page, present only when more activities matched.
`size_capped`	No	True when the page stopped before limit to keep the response small.
`availability`	No
`activity_type`	No
`activity_types`	No
`min_duration_minutes`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed26 schema fields changedv0.3.1Oct 24, 2026

addedInput schema / properties / activity_type / description

Added value: +"Optional exact Garmin activity type, matched case-insensitively, e.g. running or cycling. Omit for all types; blank strings are invalid."

addedInput schema / properties / days / description

Added value: +"Number of days from 1 to 90, ending today inclusive; defaults to 14."

addedInput schema / properties / days / maximum
```
Added value: +90
```
addedInput schema / properties / days / minimum
```
Added value: +1
```

addedInput schema / properties / limit / description

Added value: +"Maximum number of activities returned, from 1 to 100; defaults to 20. This is a result cap, not a page number."

addedInput schema / properties / limit / maximum
```
Added value: +100
```
addedInput schema / properties / limit / minimum
```
Added value: +1
```

addedOutput schema / $defs

Added value: +{
+  "ActivitySummary": {
+    "properties": {
+      "activity_id": {
+        "title": "Activity Id",
+        "type": "integer"
+      },
+      "activity_training_load": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Activity Training Load"
+      },
+      "activity_type": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Activity Type"
+      },
+      "aerobic_training_effect": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Aerobic Training Effect"
+      },
+      "anaerobic_training_effect": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Anaerobic Training Effect"
+      },
+      "average_cadence": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Average Cadence"
+      },
+      "average_hr_bpm": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Average Hr Bpm"
+      },
+      "average_moving_speed_mps": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Average Moving Speed Mps"
+      },
+      "average_power_w": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Average Power W"
+      },
+      "average_respiration": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Average Respiration"
+      },
+      "average_speed_mps": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Average Speed Mps"
+      },
+      "average_stride_length_m": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Average Stride Length M"
+      },
+      "calories_kcal": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Calories Kcal"
+      },
+      "description": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Description"
+      },
+      "distance_m": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Distance M"
+      },
+      "duration_seconds": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Duration Seconds"
+      },
+      "elapsed_seconds": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Elapsed Seconds"
+      },
+      "elevation_gain_m": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Elevation Gain M"
+      },
+      "elevation_loss_m": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Elevation Loss M"
+      },
+      "feel": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Feel"
+      },
+      "has_description": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Has Description"
+      },
+      "highest_respiration": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Highest Respiration"
+      },
+      "hr_zones_seconds": {
+        "anyOf": [
+          {
+            "additionalProperties": {
+              "type": "number"
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Hr Zones Seconds"
+      },
+      "intensity_factor": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Intensity Factor"
+      },
+      "lowest_respiration": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Lowest Respiration"
+      },
+      "max_cadence": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Max Cadence"
+      },
+      "max_hr_bpm": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Max Hr Bpm"
+      },
+      "max_power_w": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Max Power W"
+      },
+      "moderate_intensity_minutes": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Moderate Intensity Minutes"
+      },
+      "moving_duration_seconds": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Moving Duration Seconds"
+      },
+      "name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Name"
+      },
+      "normalized_power_w": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Normalized Power W"
+      },
+      "perceived_effort": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Perceived Effort"
+      },
+      "recovery_hr_bpm": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Recovery Hr Bpm"
+      },
+      "start_time": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Activity start: ISO 8601 with an explicit UTC offset, e.g. 2026-10-09T23:18:16+02:00. The wall time is already local; never add the offset again. The offset is the one Garmin recorded for the device at that moment, or this computer's time zone when Garmin gives only UTC.",
+        "title": "Start Time"
+      },
+      "steps": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Steps"
+      },
+      "training_effect_label": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Training Effect Label"
+      },
+      "training_stress_score": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Training Stress Score"
+      },
+      "vigorous_intensity_minutes": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Vigorous Intensity Minutes"
+      },
+      "vo2_max": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "title": "Vo2 Max"
+      }
+    },
+    "required": [
+      "activity_id"
+    ],
+    "title": "ActivitySummary",
+    "type": "object"
+  },
+  "AvailabilityNotice": {
+    "properties": {
+      "field": {
+        "title": "Field",
+        "type": "string"
+      },
+      "message": {
+        "title": "Message",
+        "type": "string"
+      },
+      "status": {
+        "title": "Status",
+        "type": "string"
+      }
+    },
+    "required": [
+      "field",
+      "status",
+      "message"
+    ],
+    "title": "AvailabilityNotice",
+    "type": "object"
+  }
+}

addedOutput schema / properties / activities

Added value: +{
+  "items": {
+    "$ref": "#/$defs/ActivitySummary"
+  },
+  "title": "Activities",
+  "type": "array"
+}

addedOutput schema / properties / activity_type

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Activity Type"
+}

addedOutput schema / properties / activity_types

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Activity Types"
+}

addedOutput schema / properties / availability

Added value: +{
+  "items": {
+    "$ref": "#/$defs/AvailabilityNotice"
+  },
+  "title": "Availability",
+  "type": "array"
+}

addedOutput schema / properties / count

Added value: +{
+  "description": "Number of activities returned.",
+  "title": "Count",
+  "type": "integer"
+}

addedOutput schema / properties / end_date

Added value: +{
+  "title": "End Date",
+  "type": "string"
+}

addedOutput schema / properties / limit

Added value: +{
+  "title": "Limit",
+  "type": "integer"
+}

addedOutput schema / properties / matched

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Activities in the range that passed every filter.",
+  "title": "Matched"
+}

addedOutput schema / properties / min_duration_minutes

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Min Duration Minutes"
+}

addedOutput schema / properties / next_offset

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "offset for the next page, present only when more activities matched.",
+  "title": "Next Offset"
+}

addedOutput schema / properties / offset

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Offset"
+}

addedOutput schema / properties / order

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Order"
+}

removedOutput schema / properties / result

Removed value: -{
-  "items": {
-    "additionalProperties": true,
-    "type": "object"
-  },
-  "title": "Result",
-  "type": "array"
-}

addedOutput schema / properties / size_capped

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "True when the page stopped before limit to keep the response small.",
+  "title": "Size Capped"
+}

addedOutput schema / properties / start_date

Added value: +{
+  "title": "Start Date",
+  "type": "string"
+}

addedOutput schema / properties / truncated

Added value: +{
+  "description": "True when more activities matched than this response holds; pass next_offset as offset to get the rest.",
+  "title": "Truncated",
+  "type": "boolean"
+}

changedOutput schema / required

Previous value: -[
-  "result"
-]New value: +[
+  "start_date",
+  "end_date",
+  "limit",
+  "count",
+  "truncated"
+]

changedOutput schema / title

Previous value: -"get_recent_activitiesOutput"New value: +"ActivityList"

First observedv0.1.0Aug 31, 2026

TDQS

A4.8/5.0

Behavior5/5

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

Beyond the annotations, the description discloses that authentication is local/cached (garmin-owl-auth), that the call may write to the local cache, that it never mutates the Garmin account, and that failures are not retried automatically. It also notes that filtering precedes the result limit, which materially changes how an agent should interpret a capped result.

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

Conciseness4/5

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

The purpose and the sibling routing are front-loaded, and most sentences carry operational weight. The 'returns the same envelope as get_activities' clause is mildly redundant given an output schema exists, and the auth block is dense, but nothing is pure filler.

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

Completeness5/5

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

Given three simple params, full schema coverage, and an output schema, the description covers what the schema cannot: authentication prerequisites, cache side effects, retry behavior, and truncation semantics. An agent has everything needed to call it and interpret the result.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3 and the schema already documents days, limit, and activity_type. The description still adds real meaning: filtering precedes the limit cap and the returned start_time is ISO 8601 with an explicit UTC offset already local, which the schema does not say.

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 opens with a specific verb+resource ('List activity summaries') and pins the scope precisely to the last 1-90 days ending today, with an optional type filter. It then explicitly names the two nearest siblings (get_activities, get_activity) so an agent can distinguish them without opening any schema.

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

Usage Guidelines5/5

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

'Use for recent runs/rides; use get_activities for explicit calendar dates or get_activity for detail by ID' gives an explicit when-to-use plus the two alternatives and the condition that selects each. Nothing about tool selection is left to inference.

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