garmin-personal-mcp

what's new.

What each new version of garmin-personal-mcp adds and corrects.

v0.14.0

This release adds a new period choice for your dashboard page and clearer labels on the page.

  • Start your page on a day. Choose a day, for example the first day of a plan, and each update adds the new week, up to 52 weeks.
  • See the year in your dates. The week menus, a custom range and the period comparison show the year, and the window buttons say "Last 4 weeks".

All changes in v0.14.0 (opens in a new tab)

v0.13.0

This release adds a coach review of your rides, gives more data for your race preparation, and keeps your data files private.

  • Get a coach's view of your rides. The new ride-review prompt shows speed, climbing, power, trail grit and flow, and earlier rides of the same name.
  • Check your race training block. race-readiness shows the easy and hard share of each week, and names each week with a long run over 35% of its km.
  • Get more complete reviews. A review by activity name now also finds older activities, and strength-review marks the rest-pause sets of your plan.
  • Keep your data private. On macOS and Linux, only you can read new data files, and your coach can still open a new coach page in a shared folder.

All changes in v0.13.0 (opens in a new tab)

v0.12.0

This release compares your workouts with your plan, adds coach analytics for swimming, and makes your dashboard tidier and more reliable.

  • Follow your plan. Run and strength reviews, week-review and a new Strength board widget show which planned exercises and laps you hit or missed.
  • Get a coach's view of your swims. The Swim board shows a technique trend, and the new swim-review and swim-readiness prompts review a swim and check event readiness.
  • Get tidier boards. Rows have one height, every sport tab has a Records tile, and Auto-arrange in edit mode fills the rows in your widget order.
  • Trust your numbers. A lift's status now compares recent sessions with the sessions before them, and your assistant gives the same numbers as your page.

All changes in v0.12.0 (opens in a new tab)

v0.11.0

This release adds new ways to follow your training and recovery, and it makes the data on your page more reliable.

  • Review your last week. The new week-review prompt compares your last whole week with up to 4 weeks before it and gives a short coach note.
  • See more of your recovery. The Recovery board now shows stress, and a new recoveryHistory setting adds weekly sleep and resting HR trends for the whole period.
  • Compare equal periods. Period comparison now uses the same number of days in the two periods, so some numbers on your page change after the update.
  • Trust your updates. Sessions that your watch syncs up to 14 days late now arrive, and the schedule status says when an update has gaps.

All changes in v0.11.0 (opens in a new tab)

v0.10.1

This release makes new versions easier to follow and corrects two setup problems.

  • Read what is new without GitHub. The note on your updated dashboard now opens the What's new (opens in a new tab) page, which also tells how to update.
  • Keep your key in a file in Claude Desktop. The guide now gives correct steps, so your configuration file stays valid.
  • See why a schedule fails. On Linux, when crontab refuses a long crontab, the setup of a scheduled refresh now shows the error and does not crash.

All changes in v0.10.1 (opens in a new tab)

v0.10.0

This release lets you save your API key, test your setup and get help for each command in the terminal, on macOS, Linux and Windows.

  • Save your API key with one command. setup tests the key with Garmin and saves it in a file that only you can read.
  • Find and correct problems. doctor tests your setup and tells how to correct a failure. doctor and info do not show your API key or your user name, so you can share their output.
  • Get help. Add --help to a command to see how to use it. A wrong command or flag now shows an error and the help, and the server does not start.

All changes in v0.10.0 (opens in a new tab)

v0.9.0

The new info command shows the version, the settings and where your files are, and it does not connect to the network. A sport now gets a dashboard tab only when the page has its activities, and more sports have a matching icon.

All changes in v0.9.0 (opens in a new tab)

v0.8.1

run-review now compares each lap with the correct planned step. A page block that a hand edit made too deep now gives an error with the remedy. A new guide shows the setup in Claude Desktop without a terminal.

All changes in v0.8.1 (opens in a new tab)

v0.8.0

The Bike board now shows grit and flow for mountain-bike rides, the vertical speed of each ride and the weekly easy and hard time. A dashboard update with many activities no longer fails.

All changes in v0.8.0 (opens in a new tab)

v0.7.0

This release adds a daily training verdict, gives the same numbers in the chat and on the page, and tells you what an update adds.

  • A verdict for today. Use the train-today prompt to get a readiness verdict with its inputs and a short coach note.
  • The same numbers everywhere. Your assistant now quotes the numbers of the server for long runs, race predictions, splits, HR drift, rep fade, top sets and estimated 1RM.
  • New widgets on your boards. A board that you edited now gets each new preset widget one time, and a widget that you removed stays removed. The page and your assistant tell you what an update added.
  • Fewer problems. An expired API key now gives the steps to replace it. A rebuild keeps your added languages, and an update keeps edits that you make in the chat at the same time.

All changes in v0.7.0 (opens in a new tab)

v0.6.0

This release shows the dashboard in the chat and makes automatic updates and page data more reliable.

  • Dashboard in the chat. Ask your assistant to show the dashboard inside the chat. Claude Desktop is the tested client, and terminal clients get a text reply.
  • No hidden missed updates. A page now shows a note when its automatic update is over 1 hour late. On macOS and Windows, an update that the computer missed runs later. A failed crontab read no longer replaces your crontab.
  • Correct numbers. A missing value now shows n/a or a gap, not 0. A page with fewer than 28 days of data shows n/a for the load ratio.

All changes in v0.6.0 (opens in a new tab)

v0.5.0

This release adds coach analyses for running and strength training, and prompts that review your sessions.

  • Running. The dashboard shows HR drift, the weekly 5 km and 10 km pace, fitness, fatigue and form. run-review judges one run, and race-readiness judges your readiness for a race.
  • Strength. The Strength board shows which lifts do not improve. strength-review compares the sets that you did with the plan.
  • Better answers in the chat. Your assistant now reads the totals from the server and gets much shorter sleep data. Tool results do not contain your Garmin user ID or name.

All changes in v0.5.0 (opens in a new tab)

v0.4.0

The dashboard has two new themes, Munich and Munich dark, and the project has a website. When you rebuild a page that updates automatically, your assistant now tells you the schedule and the next run.

All changes in v0.4.0 (opens in a new tab)

v0.3.0

This release updates your dashboard on a schedule and gives you more control of what each page shows.

  • Automatic updates. Set a schedule, and the dashboard updates without your assistant and without tokens.
  • Filter by activity name. See only the sessions of a training plan, on the dashboard or in the chat.
  • Your own page. Each page gets your custom widgets, in the languages of the page. You can also set the title and the headline of a preset or blank page.

All changes in v0.3.0 (opens in a new tab)

v0.2.0

This release shows the dashboard in your language and units, and gives your assistant more Garmin data.

  • Your language and units. The dashboard now uses the units and the language of your Garmin profile. German, French, Spanish and Portuguese are new.
  • More data. Ask your assistant about your weight, your Body Battery and the planned workout of an activity.

All changes in v0.2.0 (opens in a new tab)

v0.1.1

The README now tells how to connect Codex and other stdio MCP clients. The dashboard page and the prompts say "your assistant" in place of Claude.

All changes in v0.1.1 (opens in a new tab)

All versions and their full lists of changes (opens in a new tab)