io.github.colincooperio/garmin-mcp
NPM · GARMIN-MCP
Ask your AI assistant about your Garmin training, sleep and recovery data
Available components
Last scanned (13 hours ago)
Scores higher than 81% of npm servers
Category Health and Science
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 0 of 3 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to colincooperio/garmin-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 4 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability77
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management40
- Stability observed for 12 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage99
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 96% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 28 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 29 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (16)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Nov 26 +1
- Package version: 1.4.2 → 1.4.3 functional
- 16 Nov 26 0
- Stability: 0.20 → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- Package version: 1.4.1 → 1.4.2 functional
- 15 Nov 26 +12
- Known CVEs: unverified → pass ▲ security
- Dependency health: unverified → 1.00 ▲ functional
- 14 Nov 26 −11
- Known CVEs: pass → unverified ▼ security
- Schema quality: 5349 → 6326 ▼ functional
- Dependency health: 1.00 → unverified ▼ functional
- Package version: 1.3.0 → 1.4.1 functional
- Package version: 1.3.0 → 1.4.0 functional
- 13 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Nov 26 +1
- Security disclosure: fail → pass ▲ functional
- 10 Nov 26 +12
- Known CVEs: unverified → pass ▲ security
- Dependency health: unverified → 1.00 ▲ functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed npm/garmin-mcp@1.4.3
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | colincooperio/garmin-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/colincooperio/garmin-mcp/.github/workflows/release.yml@refs/tags/v1.4.3 |
| Rekor log index | 3944160905 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:7141f384e63b6978ce99323d01935eb1a600d97fdacd87f2c5d738ca5d8cf20a4f8a9a21ed1187ab14a622f8f25e67fffb20e9811e0c6933645fee75f |
Background: How many MCP packages publish verified provenance →
Dependencies 3 packages
| Packages resolved | 3 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
analyze_recovery_impact Recovery vs running performance ~381
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.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_type | string | – | Parent type key, e.g. running, cycling, walking. |
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to today. |
| measure | string | – | Recovery measure to compare by; 'all' does each. Pick one for a faster answer. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Defaults to 180 days ago. |
| unit | string | – | Pace unit. Defaults to the user's Garmin unit setting. |
No output schema declared.
No examples provided.
compare_activities Compare activities ~75
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.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_ids | array | yes | 2-5 Garmin activity IDs. |
No output schema declared.
No examples provided.
get_activity Activity detail ~132
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).
| Name | Type | Req | Description |
|---|---|---|---|
| activity_id | string | yes | Garmin activity ID, from search_activities. |
| detail | string | – | compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload. |
No output schema declared.
No examples provided.
get_activity_analysis Activity analysis (splits, laps, best efforts) ~326
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.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_id | string | yes | Garmin activity ID, from search_activities. |
| include | array | – | Sections to return. Drop ones the question doesn't need for a shorter answer. |
| unit | string | – | Split length and pace unit. Defaults to the user's Garmin unit setting. |
No output schema declared.
No examples provided.
get_activity_workouts Activity workouts ~142
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.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_id | string | yes | Garmin activity ID, from search_activities. |
No output schema declared.
No examples provided.
get_body_battery Body Battery ~272
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.
| Name | Type | Req | Description |
|---|---|---|---|
| detail | string | – | compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload. |
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_daily_summaries Daily summaries ~162
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.
| Name | Type | Req | Description |
|---|---|---|---|
| detail | string | – | compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload. |
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_fitness_age Fitness age ~154
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date | – | yes | YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone). |
No output schema declared.
No examples provided.
get_heart_rate Heart rate (one day) ~198
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).
| Name | Type | Req | Description |
|---|---|---|---|
| date | – | yes | YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone). |
| detail | string | – | compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload. |
| from | string | – | Start of a full-resolution window, local HH:MM. Defaults to 00:00 when only 'to' is given. |
| to | string | – | End of the window, local HH:MM, inclusive. Defaults to 23:59 when only 'from' is given. |
No output schema declared.
No examples provided.
get_hrv HRV detail (one night) ~69
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date | – | yes | YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone). |
No output schema declared.
No examples provided.
get_hrv_summaries HRV summaries ~114
Daily heart rate variability over a range: overnight average, 5-minute high, 7-day average, baseline band, status.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_hydration Hydration ~180
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_menstrual_cycle Menstrual cycle (one day) ~113
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date | – | yes | YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone). |
No output schema declared.
No examples provided.
get_nutrition Nutrition (one day) ~56
Food log for one day: nutrition goals, calories and nutrients consumed, and per-meal breakdown.
| Name | Type | Req | Description |
|---|---|---|---|
| date | – | yes | YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone). |
No output schema declared.
No examples provided.
get_personal_bests Personal bests and race estimates ~385
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.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_type | string | – | Parent type key, e.g. running (includes trail and treadmill), walking, hiking. |
| distances | array | – | Distances to report. Defaults to all six. |
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to today. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Defaults to 365 days ago. |
| unit | string | – | Pace unit. Defaults to the user's Garmin unit setting. |
No output schema declared.
No examples provided.
get_profile Profile and HR zones ~34
User profile settings (units, measurement system, birth year, etc.) and heart-rate zones. Useful context before interpreting training data.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_readiness Readiness snapshot ~142
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date | – | – | YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone). |
No output schema declared.
No examples provided.
get_sleep Sleep (one night) ~84
One night's sleep, same compact shape as get_sleep_summaries. Use detail='full' for Garmin's complete record.
| Name | Type | Req | Description |
|---|---|---|---|
| date | – | yes | YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone). |
| detail | string | – | compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload. |
No output schema declared.
No examples provided.
get_sleep_summaries Sleep summaries ~301
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.
| Name | Type | Req | Description |
|---|---|---|---|
| detail | string | – | compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload. |
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_spo2 Pulse Ox (one day) ~105
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date | – | yes | YYYY-MM-DD, or 'today' / 'yesterday' (resolved in the user's Garmin time zone). |
| detail | string | – | compact (default) keeps the meaningful fields in readable units; full returns Garmin's raw payload. |
No output schema declared.
No examples provided.
get_steps Steps ~183
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_stress Stress ~221
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_weight Weight ~225
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_weight_goals Weight goals ~170
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
get_wellness_activity_summaries Wellness activity summaries ~176
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to start_date. Max span 92 days. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
search_activities Search activities ~529
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.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_subtype | string | – | Subtype key within activity_type, e.g. trail_running, treadmill_running, road_cycling. |
| activity_type | string | – | Parent type key, e.g. running, cycling, swimming, strength_training, walking, hiking. |
| area | object | – | Only activities that started inside this latitude/longitude box (decimal degrees). |
| detail | string | – | – |
| end_date | string | – | Only activities on/before this date. |
| event_type | string | – | Only activities tagged with this event type, e.g. race. |
| exclude_children | boolean | – | Hide the legs of multisport activities (e.g. a triathlon's swim/bike/run), keeping the parent. |
| limit | integer | – | Max results (1-100). |
| max_distance_m | integer | – | Maximum distance in metres. |
| max_duration_min | number | – | Maximum duration in minutes. |
| max_elevation_gain_m | number | – | Maximum elevation gain in metres. |
| min_distance_m | integer | – | Minimum distance in metres. |
| min_duration_min | number | – | Minimum duration in minutes. |
| min_elevation_gain_m | number | – | Minimum elevation gain in metres. |
| name_contains | string | – | Text the activity name contains (case-insensitive), e.g. 'parkrun' or 'tempo'. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| sort_by | string | – | Sort field. Use distance or averageSpeed to find longest or fastest. |
| sort_order | string | – | – |
| start | integer | – | Offset for paging. |
| start_date | string | – | Only activities on/after this date. |
No output schema declared.
No examples provided.
summarize_activities Summarize activities ~538
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.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_subtype | string | – | Subtype key within activity_type, e.g. trail_running, treadmill_running, road_cycling. |
| activity_type | string | – | Parent type key, e.g. running, cycling, swimming, strength_training, walking, hiking. |
| area | object | – | Only activities that started inside this latitude/longitude box (decimal degrees). |
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to today. |
| event_type | string | – | Only activities tagged with this event type, e.g. race. |
| exclude_children | boolean | – | Hide the legs of multisport activities (e.g. a triathlon's swim/bike/run), keeping the parent. |
| group_by | string | – | – |
| max_distance_m | integer | – | Maximum distance in metres. |
| max_duration_min | number | – | Maximum duration in minutes. |
| max_elevation_gain_m | number | – | Maximum elevation gain in metres. |
| min_distance_m | integer | – | Minimum distance in metres. |
| min_duration_min | number | – | Minimum duration in minutes. |
| min_elevation_gain_m | number | – | Minimum elevation gain in metres. |
| name_contains | string | – | Text the activity name contains (case-insensitive), e.g. 'parkrun' or 'tempo'. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
summarize_wellness Summarize wellness trends ~223
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | Last day, YYYY-MM-DD, inclusive. Defaults to today. |
| group_by | string | – | – |
| include | array | – | Data sources to include. Drop ones the question doesn't need for a faster answer. |
| period | string | – | Named period resolved in the user's time zone (weeks start Monday). Use instead of start_date/end_date. |
| start_date | string | – | First day, YYYY-MM-DD, inclusive. Required unless period is given. |
No output schema declared.
No examples provided.
How do I install the io.github.colincooperio/garmin-mcp server?
io.github.colincooperio/garmin-mcp runs locally as an npm package, launched with npx -y garmin-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · garmin-mcp
claude mcp add colincooperio-garmin-mcp -- npx -y garmin-mcp
What is the io.github.colincooperio/garmin-mcp server?
io.github.colincooperio/garmin-mcp is listed in the public MCP registry as io.github.colincooperio/garmin-mcp. Ask your AI assistant about your Garmin training, sleep and recovery data. This page covers its npm package (garmin-mcp).
Is the io.github.colincooperio/garmin-mcp server safe to use?
io.github.colincooperio/garmin-mcp scores 87 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.colincooperio/garmin-mcp server expose?
io.github.colincooperio/garmin-mcp exposes 28 tools: get_readiness, summarize_wellness, get_daily_summaries, get_profile, get_sleep_summaries, and 23 more. Their descriptions and schemas cost roughly 5,690 tokens of context every time the server is loaded.
Is the io.github.colincooperio/garmin-mcp server still maintained?
io.github.colincooperio/garmin-mcp is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.colincooperio/garmin-mcp server under?
io.github.colincooperio/garmin-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the io.github.colincooperio/garmin-mcp server?
VerifyMCP ran 16 checks on io.github.colincooperio/garmin-mcp, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.