garmin-personal-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GARMIN_MCP_DOWNLOAD_DIR | No | Where `garmin_download_activity` saves files. Defaults to `~/Downloads/garmin` (the platform downloads directory). | |
| GARMIN_PERSONAL_API_KEY | No | Personal API key; overrides the saved key file. Create a key in Garmin Connect under Settings → Personal API, or save one with `garmin-personal-mcp auth`. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| garmin_get_dayA | One day at a glance: daily summary (steps, calories, intensity minutes, resting HR, stress, body battery), last night's sleep, HRV, body battery, stress, and the day's activities. A section Garmin has no data for comes back as null or [], or as {"error": ...} when Garmin rejects that section's request; the other sections still load. date: YYYY-MM-DD (default: today). |
| garmin_get_daily_summaryB | Every all-day wellness total for one date: steps, distance, floors, total/active/BMR calories, intensity minutes, heart rate, stress, body battery, SpO2, respiration, and time active/sedentary/asleep. date: YYYY-MM-DD (default: today). |
| garmin_get_daily_summariesA | Daily wellness summaries across a date range, grouped per day (movement, calories, heart rate, intensity minutes, stress, body battery, hydration, respiration, pulse ox, jet lag). About 1-2 KB per day, so for a long trend in one metric prefer garmin_get_steps, garmin_get_stress, or garmin_get_sleep_summaries. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). Ranges over a year are fetched in yearly requests. |
| garmin_get_stepsA | Daily total steps, distance (meters), and step goal. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). Any length works; long ranges are fetched 28 days at a time. |
| garmin_get_stressA | Daily overall stress level (0-100) and seconds spent in high, medium, low, and rest stress. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). Any length works; long ranges are fetched 28 days at a time. |
| garmin_get_hydrationA | Daily water intake, goal, estimated sweat loss, and intake logged during activities, all in mL. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). Any length works; long ranges are fetched 31 days at a time. |
| garmin_get_body_batteryA | Daily Body Battery: amount charged and drained, plus the events that moved it (sleep, activities, stress) with Garmin's feedback. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). Any length works; long ranges are fetched 31 days at a time. chunks: split each day into this many intervals (e.g. 24 for hourly) and include each interval's lowest and highest level. Omitted, the every-few-minutes readings are left out to keep the response small. |
| garmin_get_heart_rateA | Resting, minimum, and maximum heart rate for a day, the 7-day resting average, and any abnormal high/low heart rate alerts. date: YYYY-MM-DD (default: today). include_samples: also return the all-day readings (large). |
| garmin_get_spo2A | Blood oxygen (pulse ox) for a day: average, lowest, latest, sleep average, 7-day average, hourly averages, and altitude acclimation. date: YYYY-MM-DD (default: today). include_samples: also return every individual reading (large). |
| garmin_get_wellness_activitiesA | Wellness activities recorded by the device, each with its type, start and end time, per-metric summary values, and time in zones. Regular workouts like runs and rides are in garmin_search_activities instead. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). |
| garmin_get_sleepA | The full sleep record for the night ending on date: sleep score and its components, deep/light/REM/awake seconds, start and end times, overnight heart rate, SpO2, respiration, sleep stress, naps, and Garmin's feedback. date: YYYY-MM-DD, the morning you woke up (default: today, i.e. last night). |
| garmin_get_sleep_summariesA | Nightly sleep records across a date range, same fields as garmin_get_sleep. Use it for sleep trends. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). Any length works; long ranges are fetched 31 days at a time. |
| garmin_get_hrvA | One night of heart-rate variability: the summary (last-night average, 5-minute high, weekly average, baseline band, status) plus every reading taken during sleep. date: YYYY-MM-DD, the morning you woke up (default: today). |
| garmin_get_hrv_summariesA | Nightly HRV summaries across a date range: last-night average, weekly average, baseline band, status, and Garmin's feedback. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). |
| garmin_get_weightA | Daily weight summaries over a range, the range average, and the nearest weigh-ins before and after it (handy when the range itself has none). Weights are in grams; body composition (BMI, body fat %, muscle and bone mass) appears when a smart scale recorded it. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). include_all: list every weigh-in per day with its time and body composition, not just the latest. |
| garmin_get_weight_goalsA | Weight goals in effect during a date range and their target ranges. start, end: YYYY-MM-DD inclusive (default: the 7 days ending today). |
| garmin_get_food_logA | Foods logged in Garmin Connect's nutrition tracker for a day, with serving sizes, calories and nutrients consumed, nutrition goals, and a per-meal breakdown. date: YYYY-MM-DD (default: today). meal_id: limit to one meal; ids appear in mealDetails of an unfiltered call. include_media: also return logged food photos. |
| garmin_search_activitiesA | Recorded activities (runs, rides, swims, strength, dives, ...), newest first, with name, type, start time, distance, duration, pace/speed, HR, power, cadence, calories, elevation, and training effect. Pass an activityId to garmin_get_activity for splits and full detail. All filters are optional and combine: start, end: YYYY-MM-DD inclusive, by the activity's local start date. Omit both to search all dates. With only end, the search covers the 7 days ending on it; with only start, it runs through today. search: text in the activity name or description. activity_type: parent type key, e.g. running, cycling, swimming, strength_training, hiking, walking. activity_subtype: a child key such as trail_running or indoor_cycling. excluded_activity_subtypes: child keys to leave out. event_type: race, training, recreation, fitness, specialEvent, or uncategorized. favorite: true for favorites only, false for non-favorites. exclude_children: hide individual legs of multisport activities. sort_by: a field such as distance, duration, or name (default: start time). sort_order: asc or desc (default desc). min_/max_distance (meters), min_/max_duration (timer seconds), min_/max_elapsed_duration (seconds including pauses), min_/max_elevation (gain, meters), min_avg_power (watts). north, south, east, west: a bounding box in decimal degrees around the start location; give all four or none. Dives: min_/max_max_depth (centimeters), deco_dive, min_/max_bottom_time (seconds). required_fields: activity fields that must be present, e.g. avgPower. limit, offset: page through results (each activity is about 3-4 KB). |
| garmin_get_activityA | Full detail for one activity: summary metrics (distance, time, pace, HR, power, cadence, elevation, training effect, calories), device and location metadata, and split/lap summaries. activity_id: activityId from garmin_search_activities or garmin_get_day. |
| garmin_get_activity_workoutsA | The structured workout(s) followed during an activity, step by step with targets. activity_id: activityId from garmin_search_activities or garmin_get_day. |
| garmin_download_activityA | Download an activity's original file (a ZIP, usually holding a .fit) and save it on the machine running this server as activity-<activity_id>.zip, replacing any earlier download. Returns the saved path, size, and the files inside. activity_id: activityId from garmin_search_activities. directory: a subfolder of the download folder to save in, e.g. "races" (default: the download folder itself). The download folder is GARMIN_MCP_DOWNLOAD_DIR, else a garmin folder in the Downloads directory; paths that lead outside it are rejected. |
| garmin_get_profileA | Profile settings: display name, measurement system and display formats, time zone, hydration units and containers, and preferred training days. Check measurementSystem before converting units for the user. |
| garmin_get_heart_rate_zonesA | Heart rate zone floors per sport, with the training method and the resting, max, and lactate threshold heart rates the zones were built on. generate_defaults: return Garmin's default zones when none are configured. |
| garmin_get_fitness_ageA | Fitness age versus chronological age as of a date, the achievable fitness age, and the components behind it (vigorous days and minutes, resting heart rate, BMI or body fat %), or the reason none is available. date: YYYY-MM-DD (default: today). full_history_scan: search all history for the latest value; false limits it to the 28 days before date. |
| garmin_get_menstrual_cycleA | Menstrual cycle summary as of a date: current phase, day in cycle, days until the next phase, period length, fertile window, predicted ovulation and cycle length, and pregnancy details when tracking a pregnancy. date: YYYY-MM-DD (default: today). |
| garmin_get_menstrual_dayA | One day in detail: logged symptoms, flow, mood, and other entries, that day's cycle summary, and weekly weight goal ranges during pregnancy. date: YYYY-MM-DD (default: today). today: the reference date for predictions (default: today). reduced: return a lighter response. skip_baby_movement: leave out kick counts. include_analysis: add Garmin's cycle analysis. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 26 tools
Most tools target distinct Garmin data domains, and single-vs-range pairs such as sleep/sleep_summaries and HRV/HRV_summaries are explicitly differentiated. Some overlap remains between aggregate tools like garmin_get_day, garmin_get_daily_summary, and garmin_get_daily_summaries and metric-specific tools, but the descriptions guide selection well.
All tools use a consistent garmin_ prefix and snake_case with predictable get_/search_/download_ verbs. Singular/plural variants are readable and follow the same convention throughout.
At 26 tools the set is on the high side, but the breadth of Garmin personal-health data justifies most tools, each covering a distinct data area. It is slightly over the ideal range but not excessive for a comprehensive read-only server.
The surface covers activities, sleep, HRV, stress, body battery, heart rate, SpO2, hydration, weight, nutrition, profile, zones, fitness age, menstrual tracking, and daily summaries. Minor gaps such as dedicated respiration or training-readiness tools exist, but core retrieval coverage is strong.