What is Garmin Personal API MCP?

It is an open-source Node.js MCP server that exposes your own Garmin data as twenty-five read-only tools. A compatible AI client launches it directly on your computer; this project does not run a hosted Garmin connector.

Where do I create a Garmin Personal API key?

Create the key on Garmin Connect's dedicated Personal API Token settings page and copy it immediately because Garmin shows it only once. Then run the local auth command. The CLI exchanges the key for a bearer token and stores both only in a user-only file on your computer.

Does this use the official Garmin Personal API?

Yes. The server uses the official Garmin Personal API for data requests and Garmin’s official FIT SDK for activity recordings. It does not use a username-and-password Garmin Connect scraper.

Can it change my Garmin account or push workouts to a device?

No. v0.1 exposes read-only operations backed by Garmin Personal API GET endpoints. It cannot create workouts, update profile data, change settings, or push content to a Garmin device.

Can I use this Garmin MCP with Claude Desktop, Cursor, Codex, or VS Code?

Yes, when the installed client can launch a local MCP server. This page has copy-and-paste setup requests for Codex, Claude Code, and Cursor. Claude Desktop, VS Code, and other clients that support local MCP servers can use the generic npx configuration in the advanced setup section.

Can my AI client install and configure Garmin Personal API MCP for me?

Yes. Paste the tailored setup request into Codex, Claude Code, or Cursor. Its agent can check the local runtime, run the package, register the local MCP server, and verify the connection. The auth command opens a temporary 127.0.0.1 page where you enter the Garmin API key yourself; the key never belongs in chat.

Does my Garmin data stay entirely on my computer?

The API key, token cache, and server stay local, and this project runs no relay. Tool results are returned to the MCP host you selected and may be processed by its model under that provider’s privacy policy.

Can an AI inspect Garmin FIT activity data?

Yes. The activity recording tool can decode laps, sessions, and sampled FIT records such as heart rate, power, cadence, pace, temperature, and coordinates. High-frequency samples and exact GPS coordinates require explicit options.

Which operating systems and Node.js versions are supported?

Node.js 22 or newer is required on macOS, Windows, or Linux. Windows hosts that cannot execute npx directly can launch it through cmd /c, as shown in the configuration tabs.

Why did the local Garmin MCP server fail to start?

Run npx -y @trainingloadai/garmin-personal-api-mcp doctor. It checks Node.js, the credential source, local file permissions, Garmin token exchange, and a read-only profile request without starting a remote service.

Garmin Personal API MCP

v0.1

Your Garmin data,ready to ask.

Use the official Garmin Personal API to bring your activities, sleep, HRV, Body Battery, heart rate, and wellness data into a compatible AI client. The open-source server runs entirely on your computer and never asks for your Garmin password.

Start locally View source

›Connect @trainingloadai/garmin-personal-api-mcp

25 read-only tools
Runs entirely locally
Official Garmin Personal API

garminpersonalapi.com/mcp

demo 01 / 03connected

›How was my recovery yesterday?

garmin_get_day

Daily summary and recovery signals

garmin_get_sleep

Sleep duration and sleep stages

garmin_get_hrv

Overnight HRV status and values

You slept 7 h 42 m, overnight HRV was inside your recent baseline, and Body Battery rose by 61 points. Yesterday looks recovered enough for a normal training day, but this is not a medical or readiness diagnosis.

How it works

Garmin Personal API data, fetched locally when you ask.

When you ask a question, the local server fetches the required data from the Garmin Personal API and returns the result to your AI client. This project runs no cloud relay and stores no Garmin data remotely; any further processing depends on the AI provider and privacy policy you choose.

Your local MCP host

A compatible AI client chooses a Garmin tool for the question you asked. No browser extension or hosted connector is required.

MCP host

The local MCP server

The Node.js process validates inputs, controls date ranges and sample volume, then returns structured results to your AI client.

local process

Garmin Personal API

Your token is sent over HTTPS directly to the Garmin Personal API. The server exposes read operations only.

official API · HTTPS

Authentication without password scraping

Your Garmin Personal API key completes authorization on your computer—not in chat.

Create a Garmin Personal API key in Garmin Connect and authorize once. The CLI stores the key and cached bearer token in a local file readable only by you. It never uses the username-and-password scraping flow found in older Garmin Connect integrations.

Credential: Personal API key
Runtime: entirely local
Operations: GET / read-only

Quickstart

Send one line to your AI client to connect to the Garmin Personal API.

Copy the request below into Codex, Claude Code, Cursor, or another AI client that can work locally. The client can check the runtime, install and configure the package, connect the tools, and open the private local authorization page; you only enter your Garmin Personal API key there.

01
Prepare your Garmin Personal API key
Create your Garmin Personal API key on Garmin Connect's dedicated Personal API Token page. Garmin shows a new key only once, so copy it before leaving—but never paste it into an AI chat. You will enter it on a private page served only by this computer.
Open Personal API Token settings ↗
02
Copy one line into your AI client
Codex, Claude Code, Cursor, or another capable coding agent can identify the npm package, read its setup instructions, and handle the client-specific details.
Paste into Codex, Claude Code, Cursor, or another agent
Connect @trainingloadai/garmin-personal-api-mcp
The detailed, machine-readable flow lives in the repository’s AGENTS.md ↗, not in your prompt.
03
Connect on the local page
The auth command opens a temporary page at 127.0.0.1. Paste the key there—not in chat. The page validates it with Garmin, saves it with user-only permissions, then closes its local listener.
Your client handlesauth → register → doctor → verify
04
Reload your client, then ask
Restart once so your client can load the newly registered Garmin tools. Then ask a question normally—there are no commands or tool names to remember.
“Summarize my sleep, HRV, Body Battery, stress, and activities for yesterday.”
Prefer the official details? Read the Codex, Claude Code, or Cursor MCP guide.

Manual setup · advanced

Prefer to wire it yourself?

The one-line agent flow above is the recommended path. These exact commands are for developers who want to inspect or configure the local process connection themselves.

Transport: local process (stdio)
Protocol test: Initialize · List Tools · Call Tool
Last verified: October 23, 2026

This package never needs a server URL, Docker container, or hosted account. Restart the client after changing its MCP configuration.

Codex CLI

codex mcp add trainingloadai -- npx -y @trainingloadai/garmin-personal-api-mcp
codex mcp list

What you can ask

Raw Garmin data, shaped for a useful conversation.

Twenty-five focused tools turn Garmin Personal API data into bounded, useful context while preserving the original units.

Activities & FIT

Search Garmin activities, inspect workout steps, or decode FIT laps, power, heart rate, cadence, and sampled records.

search_activitiesget_activityget_activity_recording

Daily recovery

Bring sleep, HRV, Body Battery, stress, daily summaries, and fitness age into one grounded conversation.

get_dayget_sleepget_hrvget_body_battery

Sleep & HRV

Read one night in detail or compare bounded sleep and overnight HRV summaries across a recent period.

get_sleepget_sleep_summariesget_hrv_summaries

Heart & oxygen

Query heart-rate summaries, configured heart-rate zones, resting heart rate, and pulse oximetry data.

get_heart_rateget_heart_rate_zonesget_spo2

Wellness & nutrition

Read steps, hydration, stress, weight, food logs, wellness activities, and cycle data without account writes.

get_stepsget_hydrationget_weight+ 5 more

Profile context

Use profile settings and fitness age to interpret Garmin values in the context of the person they belong to.

get_profileget_heart_rate_zones

Garmin Personal API data

One local interface for activity, recovery, and health questions.

The server maps Garmin Personal API endpoints to twenty-five deliberate MCP tools—not one oversized endpoint and not a generic scraper.

Garmin activity API and FIT recordings

Search activities by date, sport, or title; inspect the activity summary and workout steps; then decode a Garmin FIT file only when lap or sampled recording detail is needed. Power, pace, cadence, heart rate, temperature, and GPS coordinates stay tied to their original units.

latest running activity
lap and power drift
FIT samples on demand

Garmin sleep, HRV, and Body Battery data

Read a single day or compare summaries across a bounded range. Sleep stages, overnight HRV, Body Battery charge and drain, and stress can be placed in the same answer without pretending that a wellness signal is a medical diagnosis.

sleep stages
HRV summaries
Body Battery trend

Heart rate and daily health summaries

Query daily summaries, steps, hydration, continuous heart-rate aggregates, SpO2, weight, food logs, and wellness activities. Exact high-frequency samples are omitted by default so a simple Garmin health question does not flood the model context.

resting heart rate
daily steps and stress
weight and hydration

Profile, heart-rate zones, and fitness context

Use the Garmin profile, configured heart-rate zones, fitness age, and cycle data to interpret a number in the context of the person it belongs to. Every tool remains a data retrieval tool; it does not issue a diagnosis or edit a Garmin account.

heart-rate zones
fitness age
profile-aware answers

Privacy boundary

A local Garmin MCP with a boundary you can inspect.

This project does not host or forward your Garmin data. Tool results do enter the AI client and model you choose, where that provider's privacy policy applies.

Read the security policy ↗

Credentials stay local

Your Garmin Personal API key and cached bearer token are stored only on your computer.

Read-only by construction

Every exposed Garmin operation is a GET. There are no workout, device, or account writes.

Private by default

High-frequency samples and exact FIT coordinates are omitted unless explicitly requested.

No telemetry

The server has no analytics, crash reporting, account system, database, or remote relay.

FAQ

Clear answers about the Garmin Personal API and MCP.

Exact answers about API keys, local operation, client support, FIT activity data, privacy, and read-only limits.

answers

One setup request

Paste one line.
Let your client handle the rest.

Paste the package request into Codex, Claude Code, Cursor, or another capable agent. It finds the setup instructions, opens the private local Garmin Personal API authorization page, and verifies the connection.

›Connect @trainingloadai/garmin-personal-api-mcp

See the four steps GitHub

Your Garmin data,ready to ask.

Garmin Personal API data, fetched locally when you ask.

Your local MCP host

The local MCP server

Garmin Personal API

Your Garmin Personal API key completes authorization on your computer—not in chat.

Send one line to your AI client to connect to the Garmin Personal API.

Prepare your Garmin Personal API key

Copy one line into your AI client

Connect on the local page

Reload your client, then ask

Prefer to wire it yourself?

Raw Garmin data, shaped for a useful conversation.

Activities & FIT

Daily recovery

Sleep & HRV

Heart & oxygen

Wellness & nutrition

Profile context

One local interface for activity, recovery, and health questions.

Garmin activity API and FIT recordings

Garmin sleep, HRV, and Body Battery data

Heart rate and daily health summaries

Profile, heart-rate zones, and fitness context

A local Garmin MCP with a boundary you can inspect.

Credentials stay local

Read-only by construction

Private by default

No telemetry

Clear answers about the Garmin Personal API and MCP.

01What is Garmin Personal API MCP?

02Where do I create a Garmin Personal API key?

03Does this use the official Garmin Personal API?

04Can it change my Garmin account or push workouts to a device?

05Can I use this Garmin MCP with Claude Desktop, Cursor, Codex, or VS Code?

06Can my AI client install and configure Garmin Personal API MCP for me?

07Does my Garmin data stay entirely on my computer?

08Can an AI inspect Garmin FIT activity data?

09Which operating systems and Node.js versions are supported?

10Why did the local Garmin MCP server fail to start?

Paste one line.Let your client handle the rest.

Paste one line.
Let your client handle the rest.