claudeers.
// MCP Servers

garmin-personal-mcp

MCP server for Garmin Connect on Garmin's official Personal API: sleep, HRV, body battery, activities, and more from Claude or any MCP client

// MCP Servers[ cli ][ api ][ desktop ][ web ][ claude ]#claude#ai-agents#claude-code#claude-desktop#fitness#garmin#garmin-api#garmin-connect#mcp-servers◷ MIT$open-sourceupdated 29 days ago
Actively maintained
100/100
last commit 17 days ago
last release 18 days ago
releases 4
open issues 7

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up garmin-personal-mcp (claude-plugin project) into my current project.
Found on https://claudeers.com/garmin-personal-mcp
Repo: https://github.com/Mason-Levyy/garmin-personal-mcp
Homepage/docs: —
Detected install method: claude-plugin → /plugin install garmin-personal-mcp@Mason-Levyy/garmin-personal-mcp
Category: mcp-servers. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add Mason-Levyy/garmin-personal-mcp
/plugin install garmin-personal-mcp@Mason-Levyy/garmin-personal-mcp
// or clone
git clone https://github.com/Mason-Levyy/garmin-personal-mcp

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
garmin-personal-mcp

Garmin MCP

Ask your AI about your Garmin data, on Garmin's official API.

Quickstart · Tools · Authentication · Changelog

Connect Garmin Connect to Claude or any MCP client. Ask about last night's sleep, HRV trends, Body Battery, training load, or a specific run, all from your real Garmin account.

Published on PyPI as garmin-personal-mcp.

Unofficial project, official API. This isn't made by Garmin, but it only talks to Garmin's documented Personal API through Garmin's own Python client.

Why this one?

Most Garmin MCP servers sign in with your Garmin password through the unofficial garminconnect library, which breaks whenever Garmin changes its login. In October 2026 Garmin opened a Personal API for individuals. This server uses it:

  • No password, no scraping: a revocable Personal API key you create in Garmin Connect, exchanged for short-lived tokens
  • The whole Personal API: every working endpoint in Garmin's reference has a tool, with every documented filter
  • Any date range: ranges longer than an endpoint allows (28 days for steps, 31 for sleep, and so on) are split into requests for you
  • Model-sized responses: all-day sample arrays are left out unless you ask for them
  • Read-only: the Personal API can't change your account, and neither can this server

Quickstart

  1. Save your Personal API key (one-time; see Authentication):

    uvx garmin-personal-mcp auth
    
  2. Add the server to your client. The install buttons at the top do this in one click for Cursor and VS Code.

    Claude Code

    claude mcp add garmin -- uvx garmin-personal-mcp
    

    Or install it as a plugin, which asks for your key in place of step 1:

    /plugin install garmin-personal-mcp --marketplace Mason-Levyy/garmin-personal-mcp
    

    Claude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), and Cline (cline_mcp_settings.json) all take the same entry:

    {
      "mcpServers": {
        "garmin": {
          "command": "uvx",
          "args": ["garmin-personal-mcp"]
        }
      }
    }
    
    VS Code, Codex CLI, Gemini CLI

    VS Code (or use the button above):

    code --add-mcp '{"name":"garmin","command":"uvx","args":["garmin-personal-mcp"]}'
    

    Codex CLI:

    codex mcp add garmin -- uvx garmin-personal-mcp
    

    Gemini CLI:

    gemini mcp add garmin uvx garmin-personal-mcp
    
  3. Ask it something: "how did I sleep last night?", "is my HRV trending down this month?", "compare my last three long runs".

Requires uv. Any MCP client that speaks stdio or streamable HTTP works, not just Claude.

Finding this useful? A ⭐ on GitHub helps other Garmin users find it.

Authentication

  1. Sign in to Garmin Connect on the web and open Settings → Personal API.
  2. Create a key and choose how long it lasts (30 days to a year). Garmin shows it once.
  3. Run garmin-personal-mcp auth and paste it at the hidden prompt. The server checks it with Garmin before saving it to ~/.config/garmin/connect-personal-api-key with owner-only permissions.

Where there's no terminal to prompt in (a script, or a shell an agent runs), pipe the key in instead, e.g. pbpaste | garmin-personal-mcp auth.

garmin-personal-mcp auth --check reports whether the saved key still works, without prompting. Garmin emails you about a week before a key expires: create a new one and run auth again. No restart is needed; the server reads the key on every call.

Instead of the key file you can set GARMIN_PERSONAL_API_KEY, which takes precedence. The key file and bearer-token cache are the same ones Garmin's gc-personal CLI uses, so a key saved by either works for both.

Tools

All tools take dates as YYYY-MM-DD. Range tools default to the 7 days ending today. Tools that return a list wrap it as {"results": [...]}.

ToolWhat it returns
garmin_get_dayOne day at a glance: summary, sleep, HRV, Body Battery, stress, and activities
garmin_get_daily_summaryEvery all-day wellness total for one date
garmin_get_daily_summariesDaily summaries across a range (trends over weeks or months)
garmin_get_stepsDaily steps, distance, and goal
garmin_get_stressDaily stress level and time in each stress band
garmin_get_hydrationDaily intake, goal, and sweat loss
garmin_get_body_batteryDaily charge/drain and the events behind it; chunks for intraday lows/highs
garmin_get_heart_rateResting/min/max HR, 7-day resting average, abnormal HR alerts; samples on request
garmin_get_spo2Pulse ox averages, hourly averages, acclimation; readings on request
garmin_get_wellness_activitiesWellness activities with summary values and time in zones
garmin_get_sleepOne night in full: score, stages, timings, overnight vitals
garmin_get_sleep_summariesNightly sleep records across a range
garmin_get_hrvOne night of HRV with every reading
garmin_get_hrv_summariesNightly HRV, weekly average, baseline, and status across a range
garmin_get_weightDaily weight summaries, range average, and adjacent weigh-ins; every weigh-in with include_all
garmin_get_weight_goalsWeight goals in effect and their target ranges
garmin_get_food_logGarmin Connect nutrition log: foods, nutrients, goals, meals
garmin_search_activitiesActivities with every filter Garmin supports (type, dates, distance, power, area, dives, ...)
garmin_get_activityOne activity in full, with splits
garmin_get_activity_workoutsThe structured workout followed during an activity
garmin_download_activitySave an activity's original file (ZIP with the .fit) on the server's machine
garmin_get_profileUnits, formats, time zone, and training-day preferences
garmin_get_heart_rate_zonesZone floors per sport and the HRs they're based on
garmin_get_fitness_ageFitness age, achievable fitness age, and its components
garmin_get_menstrual_cycleCycle phase, day, fertile window, and predictions
garmin_get_menstrual_dayOne day's logged symptoms, flow, and cycle detail

Weights are in grams, distances in meters, and durations in seconds, as Garmin returns them.

Remote / HTTP mode

The default transport is stdio. For network clients:

garmin-personal-mcp --http --host 127.0.0.1 --port 8491

This serves streamable HTTP at /mcp. There is no built-in authentication. Never expose it to the internet. Bind to localhost and front it with something that authenticates for you: a VPN or tailnet (e.g. tailscale serve), an authenticating reverse proxy, or an OAuth-aware MCP gateway. Behind a proxy, pass --allowed-host <proxy hostname> (repeatable) so the DNS-rebinding check accepts its Host header.

Configuration

VariablePurposeDefault
GARMIN_PERSONAL_API_KEYPersonal API key; overrides the saved key file–
GARMIN_MCP_DOWNLOAD_DIRWhere garmin_download_activity saves files~/Downloads/garmin (platform downloads dir)

Troubleshooting

  • "Garmin rejected the Personal API key": the key expired or was deleted. Create a new one and run garmin-personal-mcp auth.
  • "No usable Garmin Personal API key was found": run garmin-personal-mcp auth, or set GARMIN_PERSONAL_API_KEY in the client config.
  • {"no_data": ...}: Garmin has nothing for that date yet (today's HRV before you've slept, for example), or your device doesn't record that metric.
  • HTTP 400 on a long range: an endpoint without a documented limit rejected the range. Ask for a shorter one.

FAQ

Is this the official Garmin API? Yes. It uses Garmin's Personal API, which anyone with a Garmin Connect account can enable without applying, through Garmin's Apache-licensed Python client. The project itself is independent.

Can it change my Garmin data? No. The Personal API is read-only. The one tool that writes anything, garmin_download_activity, saves a file on your own machine.

Which MCP clients does it work with? Any client that runs a stdio or streamable HTTP server, including Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and VS Code. AI coding agents can follow llms-install.md.

Where does my data go? The server talks only to Garmin. Your key and bearer token stay in ~/.config/garmin/. Tool results go to whichever MCP client and model you connect it to.

Can I use it for other people's accounts? No. Garmin's Personal API is for your own data. Apps serving other users need Garmin's business developer program.

How it works

  • garmin-personal-mcp auth saves the key; each call exchanges it for a bearer token through Garmin's PersonalApiAuthenticator, which caches the token until an hour before it expires. A token rejected early gets one retry with a fresh exchange.
  • Each tool maps to one endpoint on personal.connectapi.garmin.com (garmin_get_day combines several). Ranges longer than an endpoint's documented maximum are fetched in consecutive windows and concatenated.
  • Bulky per-minute sample arrays are dropped by default to keep responses readable for a model; include_samples or chunks bring them back.

Development

git clone https://github.com/Mason-Levyy/garmin-personal-mcp
cd garmin-personal-mcp
uv sync
uv run pytest

Tests run against synthetic fixtures; no account needed. Lint and formatting are enforced with ruff (uv run ruff check ., uv run ruff format .).

Contributing

Issues and pull requests are welcome, especially when Garmin adds endpoints to the Personal API. See CONTRIBUTING.md for setup, style, and the PR checklist, and SECURITY.md for how to report vulnerabilities privately. Release history is in CHANGELOG.md.

Support the project

If this server saves you time, please star the repo. Stars are how other Garmin users find it in GitHub search and MCP directories. Bug reports and endpoint requests are just as welcome in issues.

License

MIT. Garmin and Garmin Connect are trademarks of Garmin Ltd. or its subsidiaries; this project is not affiliated with or endorsed by Garmin.

// faq

What is garmin-personal-mcp?

MCP server for Garmin Connect on Garmin's official Personal API: sleep, HRV, body battery, activities, and more from Claude or any MCP client. It is open-source on GitHub.

Is garmin-personal-mcp free to use?

garmin-personal-mcp is open-source under the MIT license, so it is free to use.

What category does garmin-personal-mcp belong to?

garmin-personal-mcp is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

47 views
★ 61 stars
unclaimed
updated 29 days ago

// embed badge

garmin-personal-mcp on Claudeers
[![Claudeers](https://claudeers.com/api/badge/garmin-personal-mcp.svg)](https://claudeers.com/garmin-personal-mcp)

// retro hit counter

garmin-personal-mcp hit counter
[![Hits](https://claudeers.com/api/counter/garmin-personal-mcp.svg)](https://claudeers.com/garmin-personal-mcp)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how garmin-personal-mcp connects across the ecosystem