Medplum MCP
Securely access and manage FHIR healthcare data stored in Medplum.
Unofficial read-only Garmin Connect data: sleep, HRV, heart rate, stress, recovery analysis.
Originaltext des Herstellers
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 0/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 12/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte Garmin Connect (unofficial). Folge https://mcp.popnx.com/i/sasha-sup-garmin-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Garmin Connect (unofficial) (auf der Seite des Anbieters erstellen) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Die .mcpb-Datei des Entwicklers herunterladen
Die .mcpb-Datei kommt direkt vom Anbieter; wir ändern sie nicht
Nutze Garmin Connect (unofficial) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Garmin Connect (unofficial) nutzt, oder ein Werkzeug von Garmin Connect (unofficial) in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
GARMIN_TZ IANA-Zeitzone, z. B. Europe/Berlin (Standard: UTC im Container) Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Garmin Connect (unofficial) noch nicht verbinden
Garmin Connect (unofficial) läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die Garmin Connect (unofficial) verbinden kann
B · Andere in Praxen & Gesundheit, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Garmin Connect (unofficial) (auf der Seite des Anbieters erstellen) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Garmin Connect (unofficial) für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user garmin --env GARMIN_API_KEY=your-value -- docker run -i --rm -e GARMIN_API_KEY ghcr.io/sasha-sup/garmin-mcp:0.1.1 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei GARMIN_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Garmin Connect (unofficial) wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user garmin --env GARMIN_API_KEY=your-value -- docker run -i --rm -e GARMIN_API_KEY ghcr.io/sasha-sup/garmin-mcp:0.1.1Ersetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Garmin Connect (unofficial) sollte in der Liste als verbunden erscheinen
Nutze Garmin Connect (unofficial) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Garmin Connect (unofficial) nutzt, oder ein Werkzeug von Garmin Connect (unofficial) in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
GARMIN_TZ IANA-Zeitzone, z. B. Europe/Berlin (Standard: UTC im Container) Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Garmin Connect (unofficial) (auf der Seite des Anbieters erstellen) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Garmin Connect (unofficial) für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "garmin": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GARMIN_API_KEY", "ghcr.io/sasha-sup/garmin-mcp:0.1.1" ], "env": { "GARMIN_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei GARMIN_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Garmin Connect (unofficial) wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
In den Einstellungen von Garmin Connect (unofficial) ist GARMIN_API_KEY leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Garmin Connect (unofficial) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Garmin Connect (unofficial) nutzt, oder ein Werkzeug von Garmin Connect (unofficial) in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
GARMIN_TZ IANA-Zeitzone, z. B. Europe/Berlin (Standard: UTC im Container) Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Garmin Connect (unofficial) (auf der Seite des Anbieters erstellen) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Garmin Connect (unofficial) für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "garmin": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GARMIN_API_KEY", "ghcr.io/sasha-sup/garmin-mcp:0.1.1" ], "env": { "GARMIN_API_KEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei GARMIN_API_KEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Garmin Connect (unofficial) wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
VS Code fragt nach einer Bestätigung; klicke Install
In den Einstellungen von Garmin Connect (unofficial) ist GARMIN_API_KEY leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Garmin Connect (unofficial) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Garmin Connect (unofficial) nutzt, oder ein Werkzeug von Garmin Connect (unofficial) in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
GARMIN_TZ IANA-Zeitzone, z. B. Europe/Berlin (Standard: UTC im Container) Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Claude Code
claude mcp add --scope user garmin --env GARMIN_API_KEY=your-value -- docker run -i --rm -e GARMIN_API_KEY ghcr.io/sasha-sup/garmin-mcp:0.1.1Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"garmin": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GARMIN_API_KEY",
"ghcr.io/sasha-sup/garmin-mcp:0.1.1"
],
"env": {
"GARMIN_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"garmin": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GARMIN_API_KEY",
"ghcr.io/sasha-sup/garmin-mcp:0.1.1"
],
"env": {
"GARMIN_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"garmin": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GARMIN_API_KEY",
"ghcr.io/sasha-sup/garmin-mcp:0.1.1"
],
"env": {
"GARMIN_API_KEY": "your-value"
}
}
}
}GARMIN_API_KEY geheim erforderlich envGARMIN_TZ envBeschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
oci: ghcr.io/sasha-sup/garmin-mcp:0.1.1mcpb: …/garmin-mcp.mcpbBasierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto sasha-sup bestätigt, dem das Repo gehört
Code zuletzt geändert: heute
Nutzt MIT
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/sasha-sup-garmin-mcp)Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Das musst du eintragen: GARMIN_API_KEY
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (0.1.1) kam vor 8 Tagen in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker, MCPB auf deinem Computer.
In derselben Kategorie: Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Securely access and manage FHIR healthcare data stored in Medplum.
Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.
An MCP server that provides CodeScene Code Health analysis tools.
Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
| Dieser Garmin Connect (unofficial) | Medplum MCP | Mirobody | Codescene MCP Server | Marrow | WHOOP — MissingMCP | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert | Wird auf deinem Rechner installiert | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation |
| Braucht Schlüssel | Ja | Nein | Nein | Nein | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Nein | Nein |
| Basisprüfungen | 3/3 | 4/4 | 3/3 | 2/3 | 3/3 | 2/4 |
| Lizenz | MIT | Apache-2.0 | Apache-2.0 | NOASSERTION | MIT | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
English | Русский
Unofficial. This project is not affiliated with, endorsed by or supported by Garmin Ltd. "Garmin" is a trademark of Garmin Ltd. or its subsidiaries; it is used here only to describe compatibility.
An MCP server that gives Claude (or any other MCP client) read-only access to your own Garmin Connect data: sleep, HRV, heart rate, stress, Body Battery, daily activity, workouts and weight. It uses the official Garmin Connect Personal API.
The main use case is personal advice on sleep and wellbeing. The server computes averages, sleep regularity, sleep shortfall, deviations from your own baseline and links between your day and your sleep; Claude turns that into concrete recommendations.
MCP (Model Context Protocol) is the standard an AI assistant uses to call external tools.
Claude Code starts
garmin-mcpas a child process and talks to it over stdin/stdout.
| Client | How |
|---|---|
| Claude Desktop | Download garmin-mcp.mcpb from the latest release and open it. Claude Desktop asks for the API key (stored securely) and time zone. Bundled for macOS (Intel and Apple Silicon), Windows x64 and Linux x64 |
| Claude Code (plugin) | /plugin marketplace add sasha-sup/garmin-mcp, then /plugin install garmin-mcp@garmin-mcp; Claude Code asks for the key. On first start the plugin downloads the release binary and verifies its SHA-256. macOS and Linux |
| Claude Code (binary) | Install the binary (row below), then claude mcp add -s user garmin -- garmin-mcp -env-file /path/to/.env |
| Binary | Archives for Linux, macOS and Windows on the releases page, or go install github.com/sasha-sup/garmin-mcp/cmd/garmin-mcp@latest |
| Docker | docker run -i --rm -e GARMIN_API_KEY -e GARMIN_TZ ghcr.io/sasha-sup/garmin-mcp as the MCP command (images for amd64 and arm64) |
| Any MCP client | Listed in the MCP Registry as io.github.sasha-sup/garmin-mcp |
| From source | make build (Go 1.27.4+; Go 1.21+ downloads it automatically) → bin/garmin-mcp |
cp .env.example .env
chmod 600 .env # only your user can read the key $EDITOR .env # set GARMIN_API_KEY and GARMIN_TZ
garmin-mcp -env-file .env -check
Claude Desktop, in claude_desktop_config.json, if you prefer the binary over the bundle:
{
"mcpServers": { "garmin": { "command": "/absolute/path/garmin-mcp", "args": ["-env-file", "/absolute/path/.env"] } } }
Or run a ready-made prompt. In Claude Code they are /mcp__garmin__sleep_review, /mcp__garmin__wellbeing_review (both take an optional number of days) and /mcp__garmin__readiness_check.
| Tool | Returns | Period |
|---|---|---|
garmin_sleep_analysis | Sleep analysis: average duration vs Garmin's baseline sleep need and weekly shortfall, median sleep onset and wake time and their spread, weekday/weekend shift (social jetlag), stage shares, sleep score trend, sleep heart rate/HRV/SpO2/breathing, and factors from the previous day (stress above your usual, late or hard workouts, low step count, late sleep onset → score, HRV and sleep heart rate with and without; differences are shown only with ≥ 5 nights in each group) | up to 366 days, default 28 |
garmin_sleep | Per night: bedtime, wake time, stages, score and sub-scores, heart rate, stress, SpO2, breathing, sleep need, Garmin's feedback | up to 366, 7 |
garmin_recovery_status | One-day readiness snapshot: sleep; HRV, resting HR, sleep HR, breathing rate and yesterday's stress each compared with your own previous 28 days (mean, SD, z-score, days of history); overnight Body Battery charge; training load of the last 7 vs 28 days; plain-language signals and the method used. Baseline-relative signals need ≥ 14 days of history | 1 day |
garmin_trends | Weekly or monthly averages: resting HR, HRV, sleep, steps, stress, Body Battery, intensity minutes, workouts, training load, weight | up to 731 days, 84 |
garmin_daily_summary | Per day: steps, distance, calories, heart rate, intensity minutes, stress, Body Battery, breathing, SpO2 | up to 366, 7 |
garmin_hrv | Overnight HRV, 7-day average, personal baseline band, Garmin status | up to 366, 14 |
garmin_body_battery | Charged/drained, min/max, events (sleep, workouts), Garmin's feedback, optional intraday timeline | up to 31, 3 |
garmin_heart_rate | Heart rate for one day in local-time intervals (5, 10, 15, 20, 30, 60, 120, 180, 240 min) | 1 day |
garmin_activities | Workouts: type, duration, distance, pace/speed, heart rate, time in zones, training load, training effect, VO2max | default 30 days, up to 100 items |
garmin_activity | Full summary of one workout | — |
garmin_profile | Time zone, heart rate zones, Fitness Age, latest weight | — |
garmin_weight | Weigh-ins: weight, BMI, body fat, muscle mass, body water | up to 731, 90 |
garmin_api_get | Raw JSON from an allow-listed endpoint (hourly SpO2, daily stress and steps, hydration, …), truncated at 100 KB. Nutrition and menstrual cycle only with GARMIN_ALLOW_SENSITIVE=1 | — |
All dates are local calendar dates (YYYY-MM-DD). Sleep is filed under the wake-up date: the night from 10 to 11 November is 2026-11-11.
The Personal API does not expose Training Readiness, Training Status, Acute Load or a VO2max trend. garmin_recovery_status computes comparable signals itself (HRV, resting HR, sleep, the sum of activityTrainingLoad over 7 and 28 days) and labels them as computed by this server, not by Garmin.
| Variable | Purpose | Default |
|---|---|---|
GARMIN_API_KEY (or GARMIN_API) | Personal API key. Without it the server starts and lists its tools, but every call returns an error explaining how to set it | — (required for data) |
GARMIN_TZ | Your IANA time zone, e.g. Europe/Berlin. Decides what "today" is. garmin_profile warns if it differs from your Garmin profile | system zone |
GARMIN_CACHE_DIR | Cache directory, or off | user cache dir: ~/.cache/garmin-mcp on Linux, ~/Library/Caches/garmin-mcp on macOS |
GARMIN_REGION | global or cn | global |
GARMIN_LOG_LEVEL | debug, info, warn, error (logs go to stderr) | info |
GARMIN_ALLOW_SENSITIVE | 1 enables the nutrition and menstrual-cycle endpoints in garmin_api_get | off |
Flags: -env-file PATH (the environment wins over the file; the file may only set GARMIN_*), -check, -clear-cache, -version.
POST /personalapitoken-service/personal-api/personal-api-key/token with Authorization: ApiKey . Every other request carries Authorization: Bearer . The token lives only in memory and is renewed 5 minutes before expiry, and once on HTTP 401. One request performs the renewal; concurrent requests wait for it, but never longer than their own timeout.400 when a period is too long: sleep and Body Battery 31 days, stress and steps 28, daily summaries 1 year. The dedicated tools split requests into chunks and run them in parallel (at most 4 at a time). garmin_api_get passes dates through unchanged, so raw stress_daily/steps_daily requests must stay within 28 days.GARMIN_CACHE_DIR. A day with data that was fetched more than 72 hours after it ended is final and never requested again; more recent days are cached for 10 minutes because the watch keeps syncing. A day without data (watch not worn or not synced yet) is re-checked every 6 hours and becomes final only after 30 days. Re-analysing a year costs a handful of requests, not hundreds. If the watch synced very late and past days came in partially, run garmin-mcp -clear-cache.429 and 5xx: up to 3 retries with exponential backoff, honouring Retry-After. Garmin does not document a rate limit.readOnlyHint.v1 directory inside GARMIN_CACHE_DIR gets mode 0700, files 0600; symlinks and oversized files in the cache are ignored. Clear it with garmin-mcp -clear-cache or by deleting the directory.-env-file accepts only GARMIN_* variables, so a tampered file cannot set HTTPS_PROXY or SSL_CERT_FILE to intercept the key.GARMIN_ALLOW_SENSITIVE=1..env and *.db are in .gitignore. If the key leaks, delete it on the Personal API Key page; every token issued for it stops working too.make test # unit tests with -race against a synthetic fake Garmin API (no real data needed)
make lint # golangci-lint v2 make vuln # govulncheck make live # every tool against the real API (needs .env); prints response sizes only make all # lint + test + vuln + build make ci-lint # validate the GitHub Actions workflows (actionlint)
Push a tag vX.Y.Z from a commit where plugin/.claude-plugin/plugin.json has version X.Y.Z. .github/workflows/release.yml then builds the archives and garmin-mcp.mcpb (GoReleaser), pushes ghcr.io/sasha-sup/garmin-mcp:X.Y.Z (amd64 and arm64) and publishes server.json to the MCP Registry with GitHub OIDC (no stored secrets).
GitHub Actions (.github/workflows/ci.yml) runs on pushes to main, on pull requests, weekly (new vulnerabilities appear without code changes) and on demand:
| Job | What it does |
|---|---|
| Lint | go mod tidy leaves go.mod/go.sum unchanged; golangci-lint v2.15.0 with .golangci.yml |
| Test | go vet, go test -race with coverage on Ubuntu and macOS, builds the binary |
| Vulnerability scan | govulncheck over the code and its dependencies |
Actions are pinned to commit SHAs, the workflow has only contents: read, and checkout does not persist the token. Dependabot proposes Go m