Search Activities
garmin_search_activitiesFind your recorded Garmin workouts by activity type, date range, distance, duration, elevation, or power, plus text search. Returns compact summaries with activity IDs for follow-up detail and file downloads.
Instructions
Search and filter the user's recorded Garmin activities (workouts), newest first by default.
Returns one page of compact activity summaries, each with an activity ID. Pass that ID to garmin_get_activity for full detail, or to garmin_download_activity_file for the original FIT/GPX file.
Examples:
"My runs last month" -> activity_type="running", start_date="2026-10-01", end_date="2026-10-31"
"Longest rides over 50km" -> activity_type="cycling", min_distance=50000, sort_by="distance", sort_order="desc"
"Find my race efforts" -> event_type="race"
Pagination: when has_more is true, call again with offset=next_offset. This covers the common filters; garmin_get_raw reaches the dive-depth, bounding-box, and field-requirement filters.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "garmin_search_activities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum activities to return. Keep low; each activity is large. | |
| offset | No | Number of activities to skip, for pagination | |
| search | No | Text to match in activity names and descriptions | |
| sort_by | No | Field to sort by, e.g. 'distance', 'duration', 'startLocal'. Defaults to start time. | |
| end_date | No | Latest activity start date, inclusive, YYYY-MM-DD (local time) | |
| favorite | No | Restrict to favorites (true) or non-favorites (false). Omit for no filter. | |
| event_type | No | Event classification: 'race', 'training', 'recreation', 'fitness', 'specialEvent', or 'uncategorized' | |
| sort_order | No | Sort direction | desc |
| start_date | No | Earliest activity start date, inclusive, YYYY-MM-DD (local time) | |
| max_distance | No | Maximum distance in meters, inclusive | |
| max_duration | No | Maximum timer duration in seconds, inclusive | |
| min_distance | No | Minimum distance in meters, inclusive | |
| min_duration | No | Minimum timer duration in seconds, inclusive | |
| activity_type | No | Parent activity type key, e.g. 'running', 'cycling', 'swimming'. Must be a parent type, not a subtype. | |
| max_elevation | No | Maximum total elevation gain in meters, inclusive | |
| min_avg_power | No | Minimum average power in watts, inclusive | |
| min_elevation | No | Minimum total elevation gain in meters, inclusive | |
| response_format | No | 'markdown' for readable text, 'json' for the exact Garmin field names and values | markdown |
| exclude_children | No | Exclude child activities such as individual legs of a multisport activity | |
| activity_sub_type | No | Activity subtype key, e.g. 'trail_running'. Must belong to activity_type when both are given. |