hannta avatar

Garmin Connect Personal API

hannta/garmin-connect-personal-api-mcp

Read-only Garmin Connect data on Garmin's official Personal API: training, sleep, HRV, recovery.

tools
27
auth
Secret needed
transport
STDIO
env var
1
last updated
Nov 6, 2026

Tools

27 tools

Public tool metadata for what this MCP can expose to an agent.

garmin_get_dayOne day at a glance: sleep, HRV, Body Battery, stress, resting HR, intensity minutes, activities

One day at a glance: sleep, HRV, Body Battery, stress, resting HR, intensity minutes, activities

No parameter schema in public metadata yet.

garmin_get_daysThe same over a date range, one row per day, with daily activity totals and training load

The same over a date range, one row per day, with daily activity totals and training load

No parameter schema in public metadata yet.

garmin_search_activitiesActivities in a date range with Garmin IDs and fastest splits, or totals per week

Activities in a date range with Garmin IDs and fastest splits, or totals per week

No parameter schema in public metadata yet.

garmin_get_activityOne activity in depth: pace, HR zones, running dynamics, power, training effect, interval totals, strength sets per exercise

One activity in depth: pace, HR zones, running dynamics, power, training effect, interval totals, strength sets per exercise

No parameter schema in public metadata yet.

garmin_get_activity_streamsOne activity's time series (HR, pace, grade-adjusted pace, cadence, power, elevation, …)

One activity's time series (HR, pace, grade-adjusted pace, cadence, power, elevation, …)

No parameter schema in public metadata yet.

garmin_get_activity_lapsOne row per lap and interval rep, from the activity's FIT file

One row per lap and interval rep, from the activity's FIT file

No parameter schema in public metadata yet.

garmin_get_sleepOne night's sleep in detail: score components with optimal ranges, sleep need and why it changed, naps

One night's sleep in detail: score components with optimal ranges, sleep need and why it changed, naps

No parameter schema in public metadata yet.

garmin_get_sleep_summariesSleep per night over a date range

Sleep per night over a date range

No parameter schema in public metadata yet.

garmin_get_hrvOne night's HRV with baseline, status and overnight readings

One night's HRV with baseline, status and overnight readings

No parameter schema in public metadata yet.

garmin_get_hrv_summariesHRV per night over a date range

HRV per night over a date range

No parameter schema in public metadata yet.

garmin_get_daily_summariesResting HR, Body Battery, stress, intensity minutes, steps per day over a date range

Resting HR, Body Battery, stress, intensity minutes, steps per day over a date range

No parameter schema in public metadata yet.

garmin_get_weightWeigh-ins and body composition over a date range

Weigh-ins and body composition over a date range

No parameter schema in public metadata yet.

garmin_get_profileProfile settings and heart-rate zones

Profile settings and heart-rate zones

No parameter schema in public metadata yet.

garmin_get_body_batteryBody Battery per day: charged, drained and the sleep / activity events behind it

Body Battery per day: charged, drained and the sleep / activity events behind it

No parameter schema in public metadata yet.

garmin_get_stressStress per day: average level and minutes at rest / low / medium / high

Stress per day: average level and minutes at rest / low / medium / high

No parameter schema in public metadata yet.

garmin_get_stepsSteps per day with goal and distance

Steps per day with goal and distance

No parameter schema in public metadata yet.

garmin_get_heart_rateOne day's resting / min / max heart rate, optionally averaged per 15 minutes

One day's resting / min / max heart rate, optionally averaged per 15 minutes

No parameter schema in public metadata yet.

garmin_get_spo2One day's blood oxygen (Pulse Ox), optionally hourly with altitude

One day's blood oxygen (Pulse Ox), optionally hourly with altitude

No parameter schema in public metadata yet.

garmin_get_fitness_ageFitness age and its components (resting HR, BMI, vigorous days / minutes)

Fitness age and its components (resting HR, BMI, vigorous days / minutes)

No parameter schema in public metadata yet.

garmin_get_heart_rate_zonesHeart-rate zones per sport

Heart-rate zones per sport

No parameter schema in public metadata yet.

garmin_get_weight_goalsWeight goals in effect (target kg)

Weight goals in effect (target kg)

No parameter schema in public metadata yet.

garmin_get_activity_workoutsThe structured workout an activity followed: steps, targets (HR, pace, power) and repeats

The structured workout an activity followed: steps, targets (HR, pace, power) and repeats

No parameter schema in public metadata yet.

garmin_get_hydrationHydration per day: intake, goal, sweat loss (ml)

Hydration per day: intake, goal, sweat loss (ml)

No parameter schema in public metadata yet.

garmin_get_food_logOne day's food log: calories and macros eaten vs. goals, per meal and food

One day's food log: calories and macros eaten vs. goals, per meal and food

No parameter schema in public metadata yet.

garmin_get_wellness_activitiesWellness sessions (e.g. Health Snapshot, breathwork) with HR, stress, HRV, SpO2

Wellness sessions (e.g. Health Snapshot, breathwork) with HR, stress, HRV, SpO2

No parameter schema in public metadata yet.

garmin_get_menstrual_cycleCycle day, period and fertile window, predictions and cycle analysis

Cycle day, period and fertile window, predictions and cycle analysis

No parameter schema in public metadata yet.

garmin_get_menstrual_dayOne day's logged flow, symptoms and moods, with that day's cycle summary

One day's logged flow, symptoms and moods, with that day's cycle summary

No parameter schema in public metadata yet.

Sponsors

Configuration

GARMIN_PERSONAL_API_KEYsecret

Garmin Connect Personal API key (optional: the auth command saves one instead)

Readme

Watch with a heart-rate line

Garmin Connect Personal API MCP

Not affiliated with or endorsed by Garmin. Garmin and Garmin Connect are trademarks of Garmin Ltd.

A read-only MCP server that gives AI assistants your own Garmin Connect training, recovery and health data through the official Garmin Connect Personal API. Run it on your own computer, or host it on your own Cloudflare account to use it from anywhere.

AI agents: to set this up for a user, follow docs/AGENT-SETUP.md.

Setup

You need a Garmin Connect Personal API key, which you create in Garmin Connect on the web.

Run locally

The quickest way, for Claude Code, Claude Desktop, Cursor, VS Code and other clients that run local servers. Needs Node.js 22+.

Paste this into your coding agent:

Connect @hannta/garmin-connect-personal-api-mcp

Or do it yourself: docs/LOCAL.md.

Host on Cloudflare


View the full README on GitHub

Details

Repository
github.com/hannta/garmin-connect-personal-api-mcp
Website
github.com/hannta/garmin-connect-personal-api-mcp#readme
Category
Data & Analytics
Package
@hannta/garmin-connect-personal-api-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1haomingkoo avatarJapan in Seasonshaomingkoo/japan-seasons-mcpLive Japan seasonal travel data — cherry blossom forecasts, autumn leaves, fruit picking, flowers & festivals. 1,700+ spots from Japan Meteorological Corporatio0stars
2henrysouchien avatarEdgarParser MCPhenrysouchien/edgar-mcpMCP stdio server for source-backed SEC EDGAR financial data from the hosted EdgarParser API.0stars
3herohunt-ai avatarHerohunt Mcpherohunt-ai/herohunt-mcpPeople search API - find 1 billion candidates across LinkedIn and GitHub with real-time data.0stars
4hug0x0 avatarMcp Reunionhug0x0/mcp-reunionMCP server for Réunion open data (data.regionreunion.com)0stars
5idnsidns avatarTenderAPI — French & EU public tendersidnsidns/tenderapi-mcpMCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.0stars
6bitquery avatarBitquery MCP Serverbitquery/mcpHosted on-chain data for AI agents: DEX trades, OHLCV, top traders, fund tracing, address labels.0stars