Releases: Jack-Abyss/claude-garmin
Releases · Jack-Abyss/claude-garmin
Release list
v0.3.0 - 26 tools, full snapshot
What's New
This release adds six new tools that let Claude analyze every workout type in detail and pull a complete data snapshot in a single call.
🏋️ Per-discipline detail tools
Five new tools provide deep, activity-specific breakdowns:
| Tool | Returns |
|---|---|
get_strength_session |
Set-by-set breakdown (reps, weight in kg, exercise category and name, total volume) plus per-exercise aggregates: set count, max weight, average reps |
get_swim_session |
Lap-by-lap data: stroke type, distance, SWOLF, stroke count. Aggregates include dominant stroke, average SWOLF, and pace per 100m |
get_bike_session |
Power metrics (avg / max / NP / IF / TSS), cadence, and time-in-zone for both heart rate and power |
get_mindfulness_session |
Yoga, meditation, and breathwork detail: heart rate, respiration rate, stress level |
get_intervals_session |
HIIT and cardio lap breakdown: active vs. rest laps, HR per lap, work-to-rest ratio |
📊 One-call comprehensive snapshot
| Tool | Returns |
|---|---|
get_full_snapshot |
All key Garmin data in a single response: recovery, fitness, training load, recent activities, zones, scores, race predictions, lactate threshold, training plans, PRs, and progress summary. Uses parallel fetching with isolated error handling per section |
🐛 Bug fixes
get_activitiesno longer filters out non-swim/bike/run sports. Strength sessions, yoga, HIIT, walking, and other activities now appear in the activity list along with theiractivity_id(required input for the new detail tools above).
📦 Install / update
cd "C:\path\to\claude-garmin"
git pull
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt --upgradeThen restart Claude Desktop.
v0.2.0 - 20 tools
What's new
Expanded from 8 to 20 MCP tools — Claude now has access to a much broader slice of your Garmin data.
🆕 New tools
| Tool | Returns |
|---|---|
get_training_plans_list |
Active and past training plans with target event and dates |
get_training_plan_detail |
Full phase breakdown + day-by-day task list (adaptive/FBT plans supported) |
get_workout_list |
Saved workouts library with sport and estimated duration |
get_workout_detail |
Step-by-step workout structure with duration, target zone, and step type |
get_lactate_threshold |
Threshold pace (min/km) and HR, threshold power and W/kg for cycling |
get_training_effect |
Aerobic and anaerobic training effect from the last session |
get_hill_score |
Hill climbing score and trend |
get_endurance_score |
Overall endurance score and breakdown by sport |
get_race_predictions |
Garmin's predicted race times for 5K, 10K, half and full marathon |
get_progress_summary |
Volume progression over a date range, aggregated by sport |
get_hr_zones |
Configured heart rate zones with bpm ranges |
get_power_zones |
Configured power zones (running and cycling) |
get_gear |
Registered shoes and bikes with usage stats, inferred from recent activities |
🐛 Bug fixes & improvements
get_workout_detail— fixed step parsing to use Garmin's actual field names (endCondition,targetType,stepType)get_lactate_threshold— fixed pace conversion for endpoints that return speed in sec/m instead of m/sget_gear— replaced brokenfilterGearendpoint (HTTP 500 on many accounts) with per-activity gear lookupget_training_plan_detail— full support for adaptive/FBT plans (adaptivePlanPhases,taskListwith correct field mapping)get_progress_summary— rewritten to compute from activity records instead of the unreliable Garmin aggregation endpoint
⚙️ Install / update
New install: see the README.
Existing install:
cd "C:\path\to\claude-garmin"
git pull
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt --upgradeThen restart Claude Desktop.
v0.1.0 — Initial release
Full Changelog: https://github.com/Jack-Abyss/claude-garmin/commits/v0.1.0