Garmin Connect
Read and write Garmin Connect activities, health data, workouts and weigh-ins
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.3.2
- Listing updated
- today
Similar MCP servers
About Garmin Connect
Garmin Connect is an MCP server for health and science. It runs locally on your machine and is started by your AI client.
This unofficial server lets an assistant answer questions about your own Garmin data, such as how you slept this week, whether swim pace held up, or how resting heart rate moved since summer. It also writes: planned strength, run, ride and swim workouts, completed strength sessions with every set encoded as a FIT file, set corrections, and weigh-ins with full body composition.
The README counts 38 tools, annotated so a client can tell the 24 that only read from the 8 that add and the 6 that delete or overwrite. A catalogue of 1,527 Garmin exercises is bundled for offline lookup, and exercise names are checked before writes with suggested near misses.
There are cautions. It uses the same private endpoints as the Garmin Connect website through python-garminconnect, which Garmin's terms do not sanction, and endpoints can change. Uploaded sessions may sync to Strava, and repeated failed logins can lock an account. Log in once in a terminal with garmin login.
Install
Run in a terminal
claude mcp add garmin-connect-api -- uvx garmin-connect-apiAdd to claude_desktop_config.json
{
"mcpServers": {
"garmin-connect-api": {
"command": "uvx",
"args": [
"garmin-connect-api"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"garmin-connect-api": {
"command": "uvx",
"args": [
"garmin-connect-api"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"garmin-connect-api": {
"type": "stdio",
"command": "uvx",
"args": [
"garmin-connect-api"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"garmin-connect-api": {
"command": "uvx",
"args": [
"garmin-connect-api"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"garmin-connect-api": {
"command": "uvx",
"args": [
"garmin-connect-api"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GARMINTOKENSDirectory holding the tokens `garmin login` writes. Defaults to ~/.garmin-api/default.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- garmin_status
- Checks the login without calling Garmin.
- find_exercise
- Finds Garmin's name for a lift.
- recent_strength_sessions
- Recent strength sessions with sets.
- week_summary
- Summary of a week of training and health.
- get_activity_laps
- Laps for runs and rides, pace per 100 for swims.
- get_trend
- Rolls a metric over a long range into periods.
What it does
- Activity detail
- Per-set strength data, laps and pool-swim pace.
- Daily health
- Steps, heart rate, stress, body battery, sleep, HRV and readiness in one answer.
- Trends
- Twelve metrics rolled up daily, weekly or monthly over up to two years.
- Workout creation
- Create and schedule strength, run, ride and swim workouts.
- Session logging
- Log completed strength sessions and correct sets.
- Body composition
- Record weigh-ins with fat, water, muscle and more.
Good for
- Review a week of sleep and recovery data
- Check pace consistency across a swim
- Plan a swim workout on your Garmin calendar
- Log a gym session with every set
- Track resting heart rate over months
Garmin Connect FAQ
Is it official?
No. It is unofficial and not affiliated with Garmin.
How do I sign in?
Run garmin login once in a terminal; the password is only typed there.
Can it delete things?
Yes, six tools delete or overwrite, and clients can ask before running them.
What does it require?
uv and Python 3.12 or newer.
How do I add Garmin Connect to Claude Code?
Run this command in your terminal: claude mcp add garmin-connect-api -- uvx garmin-connect-api
What are the best alternatives to Garmin Connect?
The closest alternatives to Garmin Connect are Tooluniverse, Oya Browser, BasalFit, Ebi Ols and Clinicaltables.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

