{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-21T23:15:37.765Z","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp","markdownUrl":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp.md","server":{"slug":"colincooperio-garmin-mcp","name":"io.github.colincooperio/garmin-mcp","registryName":"io.github.colincooperio/garmin-mcp","description":"Ask your AI assistant about your Garmin training, sleep and recovery data","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"garmin-mcp","type":"npm","identifier":"garmin-mcp","withdrawn":false,"url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp","version":"1.4.3","transport":"stdio","scoredAt":"2026-11-21T09:54:34.648Z"},"score":{"total":87,"tier":"high trust","status":"scored","weekDelta":14,"history":[{"date":"2026-11-21","total":87},{"date":"2026-11-20","total":87},{"date":"2026-11-19","total":86},{"date":"2026-11-18","total":86},{"date":"2026-11-17","total":86},{"date":"2026-11-16","total":85},{"date":"2026-11-15","total":85},{"date":"2026-11-14","total":73},{"date":"2026-11-13","total":84},{"date":"2026-11-12","total":83},{"date":"2026-11-11","total":83},{"date":"2026-11-10","total":82},{"date":"2026-11-09","total":70}]},"categories":[{"name":"Supply Chain Security","score":100,"verdict":"pass","reasons":["No malware found by supply-chain analysis.","No known CVEs affecting this package version or its production dependencies.","No install/post-install scripts declared.","0 of 3 dependencies flagged as unhealthy."],"codes":[{"code":"supplychain.malware_clean","args":{}},{"code":"cve.none","args":{}},{"code":"installscript.none","args":{}},{"code":"dephealth.assessed","args":{"deps":"3","unhealthy":"0"}}]},{"name":"Provenance & Transparency","score":100,"verdict":"pass","reasons":["Source repository is publicly reachable at the declared URL.","Cryptographically verified build provenance (signed, bound to colincooperio/garmin-mcp).","Clear OSI-approved license (MIT).","Actively maintained (last published 4 days ago).","Publishes a security disclosure policy (SECURITY.md)."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.verified","args":{"repo":"colincooperio/garmin-mcp"}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"4"}},{"code":"disclosure.present","args":{}}]},{"name":"Schema Quality & AI Usability","score":77,"verdict":"fail","reasons":["100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).","AI-judged instruction clarity (excellent).","Context-footprint check failed: tool/resource definitions use about 6326 tokens (~225/item across 28 items; 28 tools + 0 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.descriptions","args":{"pct":"100"}},{"code":"schema.ai_quality","args":{"band":"excellent"}},{"code":"schema.footprint_heavy","args":{"avg":"225","items":"28","tools":"28","tokens":"6326","resources":"0"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":40,"verdict":"partial","reasons":["Stability observed for 12 of 30 days with no destabilising changes; credit accrues until the full window elapses."],"codes":[{"code":"stability.building_history","args":{"days":"12"}}]},{"name":"Tool Coverage","score":99,"verdict":"partial","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","96% of tool parameters carry a description."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"96"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","We read all 28 captured tool definition(s), and no name or description among them implies an irreversible operation.","An AI judge read all 29 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_none","args":{"tools":"28"}},{"code":"toolsafety.manipulation_clean","args":{"units":"29","judged":"29"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28."],"codes":[{"code":"protocol.supported","args":{"latest":"2026-07-28","version":"2025-11-25"}}]}],"inconclusive":[],"malware":[],"components":[{"slug":"garmin-mcp","type":"npm","identifier":"garmin-mcp","withdrawn":false,"score":87,"current":true,"url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp","markdownUrl":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp.md"}],"facts":[{"label":"Registry","value":"npm"},{"label":"Package","value":"garmin-mcp"},{"label":"Version","value":"1.4.3"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"get_readiness","title":"Readiness snapshot","description":"Best first call for 'how recovered am I', 'should I train hard today', 'how did I sleep last night'. One compact object: that night's sleep (score, stages, HR, respiration), HRV vs baseline and status, resting HR, Body Battery, each compared with the user's previous 7 days; training load (last 7 days vs 28-day weekly average); and activities from the last 3 days. Sleep is filed under the date the user woke up, so use 'today' for last night.","inputs":[{"name":"date","type":null,"required":false,"description":"YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":142},{"name":"summarize_wellness","title":"Summarize wellness trends","description":"Best tool for wellness trends over weeks or months ('has my sleep improved', 'resting HR trend this year', 'stress lately'). Returns per-period averages only: steps, resting HR, stress, Body Battery high/low, intensity minutes (totals), respiration, sleep hours/deep/REM/score, overnight HRV, with min-max ranges for key metrics and day counts where data is missing. group_by='weekday' answers 'which days do I sleep worst / most stressed'. Range up to 366 days; fetches and aggregates in the server.","inputs":[{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to today."},{"name":"group_by","type":"string","required":false,"description":null},{"name":"include","type":"array","required":false,"description":"Data sources to include. Drop ones the question doesn't need for a faster answer."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":223},{"name":"get_daily_summaries","title":"Daily summaries","description":"One flat row per day: steps, distance, floors, calories, resting/min/max HR, intensity minutes, stress, Body Battery, respiration, SpO2, hydration. For trends over more than a few weeks use summarize_wellness instead.","inputs":[{"name":"detail","type":"string","required":false,"description":"compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload."},{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":162},{"name":"get_profile","title":"Profile and HR zones","description":"User profile settings (units, measurement system, birth year, etc.) and heart-rate zones. Useful context before interpreting training data.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":34},{"name":"get_sleep_summaries","title":"Sleep summaries","description":"Night-by-night sleep over a range, one compact row per night filed under the date the user woke up: start_local/end_local as local 'YYYY-MM-DD HH:MM'; hours of sleep, deep, light, REM and awake (and naps); sleep score with its quality and factor ratings; average HR, stress and respiration (avg/low/high); SpO2 average/lowest; sleep need vs baseline in minutes with what drove it (training load, e.g. HIGH_ACWR_AND_CHRONIC, HRV, sleep history, naps) and next night's need; Garmin's insights. For last night alone use get_readiness or get_sleep; for trends over weeks or months use summarize_wellness. Up to 92 days per call: pass a period (e.g. last_7_days, last_30_days, this_month) or start_date/end_date. detail='full' returns Garmin's raw records.","inputs":[{"name":"detail","type":"string","required":false,"description":"compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload."},{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":301},{"name":"get_sleep","title":"Sleep (one night)","description":"One night's sleep, same compact shape as get_sleep_summaries. Use detail='full' for Garmin's complete record.","inputs":[{"name":"date","type":null,"required":true,"description":"YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone)."},{"name":"detail","type":"string","required":false,"description":"compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":84},{"name":"get_hrv_summaries","title":"HRV summaries","description":"Daily heart rate variability over a range: overnight average, 5-minute high, 7-day average, baseline band, status.","inputs":[{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":114},{"name":"get_hrv","title":"HRV detail (one night)","description":"HRV summary plus individual readings for one night, times in local 'YYYY-MM-DD HH:MM'. Use get_hrv_summaries unless the readings themselves matter.","inputs":[{"name":"date","type":null,"required":true,"description":"YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":69},{"name":"get_body_battery","title":"Body Battery","description":"Daily Body Battery (Garmin's 0-100 energy estimate) over a range, one compact row per day: charged, drained, highest and lowest; the key readings the Personal API provides, in local time (about 6 a day: midnight, overnight peak, morning, afternoon, last); the events that moved it (sleep, activities, stress); and Garmin's end-of-day feedback. Event and feedback times are local too. For today's state use get_readiness; for trends over weeks or months use summarize_wellness (Body Battery high/low per period). Up to 92 days per call: pass a period (e.g. last_7_days, last_30_days, this_month) or start_date/end_date. detail='full' returns Garmin's raw report.","inputs":[{"name":"detail","type":"string","required":false,"description":"compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload."},{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":272},{"name":"get_stress","title":"Stress","description":"Day-by-day all-day stress over a range, one row per day as Garmin returns it: calendarDate, then values with overallStressLevel (Garmin's 0-100 score) and highStressDuration, mediumStressDuration, lowStressDuration and restStressDuration in seconds. For trends over weeks or months, or 'which weekday am I most stressed', use summarize_wellness (stress per period, group_by='weekday'); stress during sleep is avg_stress in get_sleep_summaries. Up to 92 days per call: pass a period (e.g. last_7_days, last_30_days, this_month) or start_date/end_date.","inputs":[{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":221},{"name":"get_heart_rate","title":"Heart rate (one day)","description":"Heart rate for one day: resting, min, max, 7-day resting average, and hourly min/avg/max in local time. Give from/to (local HH:MM) to also get every ~2-minute reading in that window, e.g. overnight or around a workout. detail='full' returns Garmin's raw payload (every reading, large).","inputs":[{"name":"date","type":null,"required":true,"description":"YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone)."},{"name":"detail","type":"string","required":false,"description":"compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload."},{"name":"from","type":"string","required":false,"description":"Start of a full-resolution window, local HH:MM. Defaults to 00:00 when only 'to' is given."},{"name":"to","type":"string","required":false,"description":"End of the window, local HH:MM, inclusive. Defaults to 23:59 when only 'from' is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":198},{"name":"get_steps","title":"Steps","description":"Day-by-day steps over a range, one row per day as Garmin returns it: calendarDate, totalSteps, totalDistance (metres) and stepGoal. get_daily_summaries has the same steps alongside floors, calories, HR and stress; for weekly or monthly averages over longer spans use summarize_wellness. Up to 92 days per call: pass a period (e.g. last_7_days, last_30_days, this_month) or start_date/end_date.","inputs":[{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":183},{"name":"get_wellness_activity_summaries","title":"Wellness activity summaries","description":"Garmin's wellness activity summaries over a range: all-day movement records kept apart from recorded workouts, returned as Garmin sends them. Often empty; for daily movement use get_daily_summaries or get_steps, and for workouts search_activities or summarize_activities. Up to 92 days per call: pass a period (e.g. last_7_days, last_30_days, this_month) or start_date/end_date.","inputs":[{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":176},{"name":"get_spo2","title":"Pulse Ox (one day)","description":"SpO2 for one day: average, lowest, sleep average, 7-day average and hourly averages, times in local 'YYYY-MM-DD HH:MM'. detail='full' adds every reading and altitude data.","inputs":[{"name":"date","type":null,"required":true,"description":"YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone)."},{"name":"detail","type":"string","required":false,"description":"compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":105},{"name":"get_fitness_age","title":"Fitness age","description":"Garmin's fitness age as of a date: chronologicalAge, fitnessAge (a decimal; round it) and previousFitnessAge, plus the components behind it, each with a value and a stale flag: rhr (resting HR), vigorousDaysAvg and vigorousMinutesAvg (weekly averages over numOfWeeksForIm recent weeks), and bmi with its lastMeasurementDate. BMI comes from the last weight entry, so it is often old. It changes slowly, so date='today' is usually all you need. This is not VO2 max, which the Personal API doesn't provide.","inputs":[{"name":"date","type":null,"required":true,"description":"YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":154},{"name":"get_weight","title":"Weight","description":"Weight and body composition measurements over a range, from a Garmin smart scale or entered manually in Garmin Connect, returned as Garmin sends them: weights are in grams (74000 = 74 kg); date is the local measurement time, 'YYYY-MM-DD HH:MM'. Often empty, since it needs a smart scale or manual entries. When nothing was recorded in the range, the result holds only previousDateWeight, the last measurement before it: check its calendarDate before treating it as current. Up to 92 days per call: pass a period (e.g. last_7_days, last_30_days, this_month) or start_date/end_date. For longer histories, make several calls.","inputs":[{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":225},{"name":"get_hydration","title":"Hydration","description":"Water intake the user logged in Garmin Connect, day by day over a range, as Garmin returns it. Usually empty: Garmin only records hydration that is logged, so an empty result means nothing was logged, not that the user drank nothing. get_daily_summaries also carries hydration_ml per day. Up to 92 days per call: pass a period (e.g. last_7_days, last_30_days, this_month) or start_date/end_date.","inputs":[{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":180},{"name":"search_activities","title":"Search activities","description":"List individual recorded activities (runs, rides, swims, strength, etc.) with the activity_id needed for get_activity and get_activity_analysis. Filter by date, type, race, distance, duration, elevation gain, name text or a lat/long box. For totals, averages or trends over weeks/months, use summarize_activities instead: it is far smaller. Default detail='compact' returns key stats only (startTimeLocal as local 'YYYY-MM-DD HH:MM', distance m, duration/movingDuration s, averageSpeed/maxSpeed m/s, HR, elevation, calories, cadence, power, training effect). Use detail='full' only when a field you need is missing, and with a small limit. Sport-specific extras such as golf scorecards, shot data or dive logs are NOT available.","inputs":[{"name":"activity_subtype","type":"string","required":false,"description":"Subtype key within activity_type, e.g. trail_running, treadmill_running, road_cycling."},{"name":"activity_type","type":"string","required":false,"description":"Parent type key, e.g. running, cycling, swimming, strength_training, walking, hiking."},{"name":"area","type":"object","required":false,"description":"Only activities that started inside this latitude/longitude box (decimal degrees)."},{"name":"detail","type":"string","required":false,"description":null},{"name":"end_date","type":"string","required":false,"description":"Only activities on/before this date."},{"name":"event_type","type":"string","required":false,"description":"Only activities tagged with this event type, e.g. race."},{"name":"exclude_children","type":"boolean","required":false,"description":"Hide the legs of multisport activities (e.g. a triathlon's swim/bike/run), keeping the parent."},{"name":"limit","type":"integer","required":false,"description":"Max results (1-100)."},{"name":"max_distance_m","type":"integer","required":false,"description":"Maximum distance in metres."},{"name":"max_duration_min","type":"number","required":false,"description":"Maximum duration in minutes."},{"name":"max_elevation_gain_m","type":"number","required":false,"description":"Maximum elevation gain in metres."},{"name":"min_distance_m","type":"integer","required":false,"description":"Minimum distance in metres."},{"name":"min_duration_min","type":"number","required":false,"description":"Minimum duration in minutes."},{"name":"min_elevation_gain_m","type":"number","required":false,"description":"Minimum elevation gain in metres."},{"name":"name_contains","type":"string","required":false,"description":"Text the activity name contains (case-insensitive), e.g. 'parkrun' or 'tempo'."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"sort_by","type":"string","required":false,"description":"Sort field. Use distance or averageSpeed to find longest or fastest."},{"name":"sort_order","type":"string","required":false,"description":null},{"name":"start","type":"integer","required":false,"description":"Offset for paging."},{"name":"start_date","type":"string","required":false,"description":"Only activities on/after this date."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":529},{"name":"summarize_activities","title":"Summarize activities","description":"Best tool for activity totals and trends (e.g. 'how far did I run each month', 'has my pace improved'). Fetches every matching activity in the range and returns only aggregates per period and type: count, distance (km and mi), moving time, elevation, longest, average speed and pace (distance-weighted), fastest average pace, average HR, training load, and time in HR zones 1-5 (minutes and %, for zone 2 / 80-20 questions). With group_by 'week' or 'month' it also returns load_trend: load per period, % change vs the previous period, and the acute:chronic ratio at the end of each, with flags for a ratio above 1.3 or a rise over 30%. Use group_by='week' for 'am I building too fast / ramping up too quickly', and for 'compare this block with my last one' (e.g. last_90_days by week, or two ranges). Range up to 366 days.","inputs":[{"name":"activity_subtype","type":"string","required":false,"description":"Subtype key within activity_type, e.g. trail_running, treadmill_running, road_cycling."},{"name":"activity_type","type":"string","required":false,"description":"Parent type key, e.g. running, cycling, swimming, strength_training, walking, hiking."},{"name":"area","type":"object","required":false,"description":"Only activities that started inside this latitude/longitude box (decimal degrees)."},{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to today."},{"name":"event_type","type":"string","required":false,"description":"Only activities tagged with this event type, e.g. race."},{"name":"exclude_children","type":"boolean","required":false,"description":"Hide the legs of multisport activities (e.g. a triathlon's swim/bike/run), keeping the parent."},{"name":"group_by","type":"string","required":false,"description":null},{"name":"max_distance_m","type":"integer","required":false,"description":"Maximum distance in metres."},{"name":"max_duration_min","type":"number","required":false,"description":"Maximum duration in minutes."},{"name":"max_elevation_gain_m","type":"number","required":false,"description":"Maximum elevation gain in metres."},{"name":"min_distance_m","type":"integer","required":false,"description":"Minimum distance in metres."},{"name":"min_duration_min","type":"number","required":false,"description":"Minimum duration in minutes."},{"name":"min_elevation_gain_m","type":"number","required":false,"description":"Minimum elevation gain in metres."},{"name":"name_contains","type":"string","required":false,"description":"Text the activity name contains (case-insensitive), e.g. 'parkrun' or 'tempo'."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":538},{"name":"get_personal_bests","title":"Personal bests and race estimates","description":"Fastest 1 km, 1 mile, 5 km, 10 km, half and marathon across many activities, each with date, activity, pace, avg HR and the next two best efforts; plus race time estimates for 5 km to marathon from the last 90 days of the range: your actual time where you ran the distance, otherwise Riegel from the effort closest in distance. Use for 'what's my 5k PB', 'fastest half this year', 'what could I run a 10k in'. These are computed from the user's activity files (fastest continuous stretch within each run), NOT Garmin's official personal records, which the Personal API doesn't provide; estimates are estimates, not Garmin's race predictor. Analyses the newest 150 matching activities per call. The first call over a long range is slow (each activity's file is downloaded once, then cached). The result starts with complete. If complete is false (the fields are then named provisional_*), the bests are NOT final: call again with the same arguments (it continues from the cache) until complete is true, or tell the user the results are partial. Defaults to the last 365 days and running.","inputs":[{"name":"activity_type","type":"string","required":false,"description":"Parent type key, e.g. running (includes trail and treadmill), walking, hiking."},{"name":"distances","type":"array","required":false,"description":"Distances to report. Defaults to all six."},{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to today."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Defaults to 365 days ago."},{"name":"unit","type":"string","required":false,"description":"Pace unit. Defaults to the user's Garmin unit setting."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":385},{"name":"analyze_recovery_impact","title":"Recovery vs running performance","description":"Does sleep, HRV or Body Battery relate to how the user runs? Pairs each run with the night before it (sleep score, hours slept, overnight HRV) and that morning's Body Battery, then compares runs after the best third of nights with runs after the worst third at the same heart rate: it fits the user's own speed-for-HR line across the runs and scores each run by how much faster or slower it was than expected for its HR, so easy and hard runs compare fairly. Returns each group's average HR and pace, the difference in s/km (or s/mi) at the same HR, and a correlation, called meaningful only at |r| >= 0.3 with 8+ runs per group. Warns when the groups' average HR differs by over 8 bpm (different kinds of runs). Races, runs under 20 minutes and manual entries are left out. Use for 'does poor sleep hurt my running', 'do I run better when my HRV is high'. Says when there's too little data to conclude; correlation, not proof. Defaults to the last 180 days and running; range up to 366 days.","inputs":[{"name":"activity_type","type":"string","required":false,"description":"Parent type key, e.g. running, cycling, walking."},{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to today."},{"name":"measure","type":"string","required":false,"description":"Recovery measure to compare by; 'all' does each. Pick one for a faster answer."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Defaults to 180 days ago."},{"name":"unit","type":"string","required":false,"description":"Pace unit. Defaults to the user's Garmin unit setting."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":381},{"name":"get_activity","title":"Activity detail","description":"One activity in detail: distance, times, pace (per km and mile), speed, HR, cadence, running dynamics, power, training effect and load, temperature, RPE/feel, and split summaries (warm-up/active/cool-down totals, not per-km; use get_activity_analysis for km/mile splits and laps). detail='full' returns Garmin's raw record (200+ fields).","inputs":[{"name":"activity_id","type":"string","required":true,"description":"Garmin activity ID, from search_activities."},{"name":"detail","type":"string","required":false,"description":"compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":132},{"name":"compare_activities","title":"Compare activities","description":"Side-by-side compact detail for 2-5 activities (same fields as get_activity), fetched in parallel. Use for 'compare my last two long runs' or 'how did this race compare with last year's'; get the IDs from search_activities.","inputs":[{"name":"activity_ids","type":"array","required":true,"description":"2-5 Garmin activity IDs."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":75},{"name":"get_activity_workouts","title":"Activity workouts","description":"The planned workout linked to one recorded activity, if any: workoutName, sport and steps, each with intensity, durationType/durationValue (metres for DISTANCE) and a target (e.g. targetType SPEED with targetValueLow/High in m/s). An activity started from one of Garmin's daily suggested workouts may carry only a workoutPhrase (e.g. EASY_WEEK_LOAD_BASE); an empty result means no workout was linked. This is the plan; for how each rep actually went use get_activity_analysis (laps). Get the ID from search_activities.","inputs":[{"name":"activity_id","type":"string","required":true,"description":"Garmin activity ID, from search_activities."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":142},{"name":"get_activity_analysis","title":"Activity analysis (splits, laps, best efforts)","description":"Per-km or per-mile splits, the watch's laps / workout reps, best efforts, time in HR zones and first-vs-second-half drift for ONE recorded activity, computed from Garmin's original FIT file. Use for 'my km splits', 'did I negative split', 'fastest 5 km in this run', 'how long in zone 2', 'did my HR drift'. splits: one row per km/mile (time, pace, cumulative time, avg/max HR, cadence, power, elevation gain/loss), timer time so pauses don't count, final partial split labelled with its distance. laps: the watch's own laps with intensity (warmup/active/cooldown/rest) and trigger (manual, distance, ...). best_efforts: fastest continuous 1 km, 1 mile, 5 km, 10 km, half and marathon the activity is long enough for, with where each started. hr_zones: time in each HR zone, as the watch recorded it with the zones in effect then (matches Garmin Connect and summarize_activities). drift: first vs second half pace, HR and aerobic decoupling. Get the ID from search_activities. Manual entries and GPX/TCX imports return a short 'unavailable' note.","inputs":[{"name":"activity_id","type":"string","required":true,"description":"Garmin activity ID, from search_activities."},{"name":"include","type":"array","required":false,"description":"Sections to return. Drop ones the question doesn't need for a shorter answer."},{"name":"unit","type":"string","required":false,"description":"Split length and pace unit. Defaults to the user's Garmin unit setting."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":326},{"name":"get_nutrition","title":"Nutrition (one day)","description":"Food log for one day: nutrition goals, calories and nutrients consumed, and per-meal breakdown.","inputs":[{"name":"date","type":null,"required":true,"description":"YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":56},{"name":"get_weight_goals","title":"Weight goals","description":"The weight goal the user set in Garmin Connect that was in effect over a range, with its goal range, returned as Garmin sends it. Empty ({}) when no weight goal is set, which is common. Pair with get_weight to track progress. Up to 92 days per call: pass a period (e.g. last_7_days, last_30_days, this_month) or start_date/end_date.","inputs":[{"name":"end_date","type":"string","required":false,"description":"Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days."},{"name":"period","type":"string","required":false,"description":"Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date."},{"name":"start_date","type":"string","required":false,"description":"First day, YYYY-MM-DD, inclusive. Required unless period is given."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":170},{"name":"get_menstrual_cycle","title":"Menstrual cycle (one day)","description":"Menstrual cycle tracking as of one date, in two parts returned as Garmin sends them: summary (Garmin's cycle summary for that date) and dayView (Garmin's day view for that date, with anything logged). Empty unless the user tracks their cycle in Garmin Connect. date accepts YYYY-MM-DD, 'today' or 'yesterday'; call once per date.","inputs":[{"name":"date","type":null,"required":true,"description":"YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone)."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":113}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-21T09:54:34.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"verified","label":"Verified","reason":"verified","reasonLabel":"Verified","discovery":"attestation_endpoint","discoveryLabel":"Registry attestation endpoint","sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":3,"partial":false,"deprecated":null,"stale":null,"noRepo":null}},"mismatches":[],"changelog":{"trackingSince":"2026-11-09","recent":[{"id":"chg_01a1f86d-619d-7181-abc6-785334bf95a2","kind":"score.total_changed","summary":"Trust score (86 → 87)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-20","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1f86d-619d-7181-abc6-785334bf95a2"},{"id":"chg_01a1e8be-3eca-70a4-b742-7601c7933822","kind":"package.version_changed","summary":"Package version (1.4.2 → 1.4.3)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e8be-3eca-70a4-b742-7601c7933822"},{"id":"chg_01a1e8be-3ecb-70d9-8550-f5dc7e36b42c","kind":"score.total_changed","summary":"Trust score (85 → 86)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e8be-3ecb-70d9-8550-f5dc7e36b42c"},{"id":"chg_01a1e414-7b73-7501-827b-f537335fe1b2","kind":"score.total_changed","summary":"Trust score (50 → 85)","materiality":"functional","direction":"improvement","scoreDelta":35,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e414-7b73-7501-827b-f537335fe1b2"},{"id":"chg_01a1e411-9f34-7096-a992-d1a41ca60c34","kind":"check.unverifiable","summary":"Stability (0.20 → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e411-9f34-7096-a992-d1a41ca60c34"},{"id":"chg_01a1e411-9f3c-7ef0-864d-8e5f510be4ff","kind":"check.unverifiable","summary":"Tool safety (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e411-9f3c-7ef0-864d-8e5f510be4ff"},{"id":"chg_01a1e411-9f3d-78fc-a559-5781f143ed0e","kind":"check.unverifiable","summary":"Capabilities (pass → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e411-9f3d-78fc-a559-5781f143ed0e"},{"id":"chg_01a1e411-9f41-70ca-bcb2-d537a79064fc","kind":"check.unverifiable","summary":"Tool coverage (100 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e411-9f41-70ca-bcb2-d537a79064fc"},{"id":"chg_01a1e411-9f43-7058-b3f7-414761917623","kind":"check.unverifiable","summary":"Schema quality (100 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e411-9f43-7058-b3f7-414761917623"},{"id":"chg_01a1e411-9f49-7d77-b592-4367df7e2b45","kind":"package.version_changed","summary":"Package version (1.4.1 → 1.4.2)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e411-9f49-7d77-b592-4367df7e2b45"},{"id":"chg_01a1e411-9f4c-77d4-8e8f-cd80883cd311","kind":"score.total_changed","summary":"Trust score (85 → 50)","materiality":"functional","direction":"regression","scoreDelta":-35,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1e411-9f4c-77d4-8e8f-cd80883cd311"},{"id":"chg_01a1de9d-0d2b-7707-aacd-e7924d9f097a","kind":"check.reverified","summary":"Known CVEs (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1de9d-0d2b-7707-aacd-e7924d9f097a"},{"id":"chg_01a1de9d-0d2c-7cdc-bbdb-bed7d49a7871","kind":"check.reverified","summary":"Dependency health (unverified → 1.00)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1de9d-0d2c-7cdc-bbdb-bed7d49a7871"},{"id":"chg_01a1de9d-0d2d-7b8d-9bfa-b0988ebf667a","kind":"score.total_changed","summary":"Trust score (73 → 85)","materiality":"functional","direction":"improvement","scoreDelta":12,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1de9d-0d2d-7b8d-9bfa-b0988ebf667a"},{"id":"chg_01a1d9b4-745a-71a3-a143-047b710f766d","kind":"check.unverifiable","summary":"Known CVEs (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1d9b4-745a-71a3-a143-047b710f766d"},{"id":"chg_01a1d9b4-745b-77d8-9510-5e2bc7183a76","kind":"check.unverifiable","summary":"Dependency health (1.00 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1d9b4-745b-77d8-9510-5e2bc7183a76"},{"id":"chg_01a1d9b4-745c-7836-8615-8a4fb8bd1ef4","kind":"package.version_changed","summary":"Package version (1.3.0 → 1.4.1)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1d9b4-745c-7836-8615-8a4fb8bd1ef4"},{"id":"chg_01a1d9b4-745c-7e8e-b724-fbe105bd8a89","kind":"score.total_changed","summary":"Trust score (84 → 73)","materiality":"functional","direction":"regression","scoreDelta":-11,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1d9b4-745c-7e8e-b724-fbe105bd8a89"},{"id":"chg_01a1d946-9910-7d9d-a312-60787a221da5","kind":"check.measure","summary":"Schema quality (5349 → 6326)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1d946-9910-7d9d-a312-60787a221da5"},{"id":"chg_01a1d946-9911-7f29-a3c9-0a777a4af4d0","kind":"package.version_changed","summary":"Package version (1.3.0 → 1.4.0)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp#chg-chg_01a1d946-9911-7f29-a3c9-0a777a4af4d0"}],"truncated":true,"feedUrl":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp/changelog.json"},"links":{"html":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp","markdown":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp.md","changelogJson":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp/changelog.json","changelogRss":"https://verifymcp.io/servers/colincooperio-garmin-mcp/garmin-mcp.xml","external":[{"label":"npm package","href":"https://www.npmjs.com/package/garmin-mcp"},{"label":"Socket report","href":"https://socket.dev/npm/package/garmin-mcp"},{"label":"Repository","href":"https://github.com/colincooperio/garmin-mcp"}]}}