authenticate_garmin
Authenticate with Garmin Connect (opens browser)
LABSCO SUMMARY
The server writes the workout; turning a sentence into steps is explicitly handed back to the model that called it.
create_garmin_workout takes a name, a sport and structured steps, and its description states that the caller should parse the natural-language description and pass structured steps in — so what lands on the watch depends on the model doing that translation, not on validation here. The other thing to plan around is the login: authenticate_garmin opens a browser, which makes an unattended or headless setup awkward, and check_garmin_auth exists so an expired session shows up before a create call fails rather than after.
What it is
A Garmin Connect workout creator with three tools: create a structured workout, check whether the stored authentication is still valid, and start the browser login.
What you get
- Workout creation from structured steps: create_garmin_workout takes a name, a sport and the workout steps, with its own description placing the job of parsing a natural-language description onto the calling model rather than the server.
- Authentication handled as its own step: check_garmin_auth reports whether the Garmin authentication is still valid, and authenticate_garmin starts the Garmin Connect login, which opens a browser.
Requirements
A Garmin Connect account, and a machine with a browser and a person at it for the login — authenticate_garmin opens a browser, and check_garmin_auth is how you find out the session has lapsed.
Setup effort
One command — npx -y garmin-workouts-mcp
USE CASES
01
Getting an interval session onto the watch without tapping it in
Confirm the Garmin session is still good, then send the workout as name, sport and structured steps.
02
Re-establishing the Garmin session after it lapses
Check the authentication, and run the browser login when it has expired so the next create does not fail.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
check_garmin_auth
Check if Garmin authentication is valid
create_garmin_workout
Create a workout in Garmin Connect from structured workout data. Claude should parse the natural language description and pass structured workout steps.
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected.
Requires
- npx on PATH
- Node.js 16+
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"garmin-workouts-mcp": {
"command": "npx",
"args": [
"-y",
"garmin-workouts-mcp"
]
}
}
}npx
TERMINAL
npx -y garmin-workouts-mcp
