garmin-personal-mcp

every sport,
one assistant.

Your Garmin training in your assistant, through the official Garmin Connect Personal API. Read-only, runs with one command.

add it to your MCP client

Node.js 22 or later and a Garmin Personal API key. Set it up in three steps. No terminal? Step-by-step setup in Claude Desktop.

npx -y @indaco/garmin-personal-mcp@latest
activitiespace, heart rate, HR zones, load and effect, by date, type or name
laps and setsfrom the original .FIT files, with the muscles of each set
recoveryHRV, sleep, heart rate, stress and Body Battery

ask in your own words.

In any language. Your assistant chooses the tools and can combine their data. Some examples:

running

Recovery goes with every sport: “How did I sleep this week, and how was my HRV?” uses getSleep and getHrvRange.

Or let a coach prompt guide the assistant:

prompt what it does
run-reviewreviews one run as a coach
race-readinesstells if you are ready for a race, with a plan for its pace
strength-reviewreviews one strength session as a coach
swim-reviewreviews one swim as a coach
swim-readinesstells if you are ready for a swim event
ride-reviewreviews one ride as a coach
train-todaytells if you should train hard today, with fitness and form
week-reviewreviews your last whole week against the weeks before

your training dashboard, written by the server.

Your training load next to HRV, sleep and resting heart rate. The server writes the page from its template, and your assistant writes only the coach notes. The page is the same in every client.

Open the demo dashboard: its boards, edit mode and themes
The training dashboard, with demo data. open the demo
also in the chat
In Claude Desktop (tested), showDashboard shows the page in the chat. No file. The page gets the full data. The assistant gets the digest, not the full data.
one HTML file
Works offline. Chart.js is inside, and the page's own code sends no requests.
less than a minute
with the preset or the blank layout.
a board for each sport
plus a board for all your training and a Recovery board. Move, resize, hide and add widgets.
your layout stays
An update replaces the data and the coach notes. It changes your layout only to add a new preset widget. Updates can also run on a schedule.
13 themes, your languages
six dark, four light, two high-contrast, and System. Munich and Munich dark use the colours of this site.
prompt what it does
training-dashboardmakes the page
training-dashboard-updateadds the new data, your layout stays
dashboard-setupmakes a page for you or for your coach, with only the sports and the data that you select
dashboard-widgetmakes a new widget from your idea
dashboard-languageadds a language to the page

start in three steps.

You need Node.js 22 or later and a Garmin Connect account with access to the Personal API.

You do not use a terminal? Follow the step-by-step setup in Claude Desktop.

1

create a personal API key

Open the API key page in Garmin Connect web, select Create Key and choose the expiry. Garmin shows the key only one time. This command tests it and saves it in a file that only you can read:

npx -y @indaco/garmin-personal-mcp@latest setup

You can also give the key in GARMIN_PERSONAL_API_KEY.

2

connect your client

Settings → Developer → Edit Config. Add a top-level mcpServers key, then quit Claude Desktop fully and start it again.

{
  "mcpServers": {
    "garmin-personal": {
      "command": "npx",
      "args": ["-y", "@indaco/garmin-personal-mcp@latest"]
    }
  }
}

Other stdio MCP clients: command npx, arguments -y @indaco/garmin-personal-mcp@latest.

3

ask your assistant

Start a new chat and ask about your training. To make the dashboard, run the training-dashboard prompt.

List my last 5 activities, with pace and heart rate.

The server stores the .FIT files and the dashboard in ~/workspace/garmin-data. Set GARMIN_DATA_DIR to use a different folder.

20 tools, all of the Personal API.

Each tool returns JSON to your assistant. garminGet reads the endpoints that have no tool of their own.

listActivitieseach activity with pace, HR, load and effect, by date, type or name
getActivitythe details of one activity
getActivityLapsthe laps of an activity, from its .FIT file; for a run also the half split, HR drift, the fade of each step, and hit or miss per plan step; for a swim also metres, pace per 100 m, stroke, lengths, SWOLF, strokes and the fade of each repeated set
getActivitySetsthe strength sets of an activity, with the muscles, the top set and the e1RM, and the planned workout against the done sets, with the planned rest, from its .FIT file
getActivityWorkoutsthe planned workout of an activity as it is now in Garmin Connect: steps, targets and notes
downloadActivityFitsaves the .FIT file of an activity in the data folder
getHrvRangeHRV during the night
getDailyHeartRatethe heart rate of a day, with the resting HR
getSleepthe sleep of a night, or of up to 14 nights: hours, phases, score and need
getWeightweight and body composition for a range of dates
getBodyBatteryhow Body Battery charged and drained, for up to 14 days
getHeartRateZonesyour HR zones
getFitnessAgefitness age against actual age
getDailySummarysteps, stress and Body Battery, for a day or a range
getDashboardDataall the dashboard data in one call, with the server's totals and a local cache
writeDashboardwrites the dashboard page
editDashboardchanges the layout, the custom widgets and the languages of the page
showDashboardshows the dashboard inside the chat, in Claude Desktop
scheduleDashboardRefreshupdates a dashboard page automatically, at the times you say in your own words
garminGetall other GET endpoints of the Personal API

The tools guide gives the endpoints, the details of each tool and the data that the Personal API does not have.

official and read-only

Uses the Garmin Connect Personal API. It writes nothing back to Garmin.

your key stays secret

The server sends the API key only to the Garmin token endpoint, and never logs or returns the key or the access token.

your files stay local

.FIT files and the dashboard are in your data folder. The page's own code sends no requests.

every stdio client

Claude Desktop, Claude Code, Codex and the other MCP clients that use stdio.