Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GARMIN_PASSWORD | Yes | Garmin Connect password used for authentication. | |
| GARMIN_TIMEZONE | No | Timezone for date calculations (IANA ID like 'Asia/Seoul' or 'America/Los_Angeles', or offset like 'UTC+09:00'). Defaults to 'UTC' if not set. | UTC |
| GARMIN_USERNAME | Yes | Garmin Connect email address used for authentication. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_personal_records | Get personal best times for running distances (5K, 10K, half marathon, full marathon) |
| get_vo2max | Get current VO2 Max value and historical data |
| get_training_status | Get current training status including training effect, load balance, and fitness trends |
| list_training_plans | List available Garmin running training plans with optional filters for goal distance and experience level |
| get_training_plan_overview | Summarize a specific Garmin training plan including high-level details, phases, and schedule preview |
| get_training_plan_schedule | Build a weekly schedule snapshot for a training plan, including personal calendar alignment when available |
| get_gear_insights | Analyze running gear usage to surface mileage totals, replacement alerts, and recent utilization patterns |
| get_recent_running_activities | Get recent running activities with cursor-based pagination. Returns activities with pagination metadata and resource URIs for detailed data. |
| get_activity_summary | Get basic activity information including distance, time, pace, and elevation |
| get_activity_details | Get comprehensive activity metrics including splits, advanced metrics, and performance data. Response size optimized for Claude context window. |
| get_heart_rate_metrics | Get heart rate metrics including resting heart rate and heart rate variability (HRV) |
| get_sleep_analysis | Get detailed sleep data including sleep stages, quality, and duration |
| get_body_battery | Get body battery energy levels throughout the day |
| get_stress_levels | Get stress level data and analysis |
| get_daily_activity | Get daily activity metrics including steps, floors climbed, and intensity minutes |
| calculate_training_paces | Calculate Jack Daniels training paces based on recent race performance |
| get_advanced_running_metrics | Get advanced running metrics including stride length, vertical ratio, vertical amplitude, ground contact time |
| analyze_heart_rate_zones | Analyze heart rate zone distribution and time spent in each zone for an activity |
| set_race_goal | Set a target race goal and track progress |
| analyze_training_load | Analyze training load and recovery status to prevent injury |
| get_running_trends | Get running performance trends over a specified period. Response size optimized for Claude context window. |
| get_lactate_threshold | Get lactate threshold pace and heart rate data |
| get_race_predictions | Get predicted race times based on current fitness level |
| get_training_readiness | Get training readiness score and recommendations |
| get_recovery_time | Get recommended recovery time after recent activities |
| get_training_load_balance | Get acute vs chronic training load balance (ATL/CTL ratio) for injury prevention |
| get_training_effect | Get aerobic and anaerobic training effect analysis |
| calculate_vdot_zones | Calculate VDOT and training zones based on recent race performance or time trial |
| analyze_threshold_zones | Analyze lactate threshold zones for double threshold training |
| suggest_daily_workout | Suggest appropriate workout based on current condition and training phase |
| analyze_workout_quality | Analyze how well a workout was executed compared to plan |
| get_endurance_score | Get endurance performance score indicating aerobic endurance capability |
| get_hill_score | Get hill running performance score indicating uphill running capability |
| get_hrv_data | Get detailed heart rate variability (HRV) data for recovery and stress analysis |
| get_respiration_data | Get daily respiration data including breathing rate and patterns |
| get_spo2_data | Get blood oxygen saturation (SpO2) levels throughout the day |
| get_paginated_activities | Get activities with proper pagination support to handle large datasets |
| get_activities_for_date | Get all activities for a specific date |
| get_devices | Get information about all connected Garmin devices |
| get_primary_training_device | Get primary training device information for running activities |
| get_device_settings | Get device settings and configuration |
| download_activity_file | Download activity data in various file formats (TCX, GPX, FIT) |
| get_weekly_running_summary | Get comprehensive weekly running summary with trends and analysis |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Activities List | Paginated list of running activities with cursor-based navigation |
| Full Activity Details | Complete activity data including all metrics, charts, and GPS data |
| Activity Splits | Detailed split/lap data for an activity |
| Heart Rate Zones | Heart rate zone distribution and analysis for an activity |
| Advanced Metrics | Advanced running metrics (cadence, GCT, vertical oscillation, etc.) |
| Monthly Trends | Monthly running trends and statistics with pagination |