Skills

gccli: Garmin-Connect-Daten per Kommandozeile und Agent abfragen

gccli eignet sich am besten, um Aktivitäten, Gesundheits- und Körperzusammensetzungsdaten aus Garmin Connect direkt im Terminal oder in einem Agent-Client abzufragen und die JSON- oder plain/TSV-Ausgabe an Skripte weiterzugeben. Vor der Nutzung ist die Garmin-SSO-Anmeldung Pflicht, und die Fallback-Token-Datei ist mit einer festen, im Quellcode eingebetteten Passphrase verschlüsselt – prüfe zuerst, ob du das akzeptierst.

Official source · gccli — A command-line interface for Garmin Connect

Install

brew install bpauli/tap/gccli

Für wen es geeignet ist

gccli ist ein Kommandozeilen-Tool für Garmin Connect und wird offiziell als „schnelle, skriptfreundliche CLI“ positioniert, mit Zugriff auf Aktivitäten, Gesundheitsdaten, Körperzusammensetzung, Workouts, Kurse, Geräte, Ausrüstung, Ziele und Abzeichen. Geeignet ist es für:

  • Alle, die ihre Garmin-Daten direkt im Terminal abfragen und die Ergebnisse in Skripte überführen wollen: Das offizielle Projekt bietet zwei parsebare Ausgabemodi, JSON und plain/TSV, ausdrücklich für Skripte und Automatisierung.
  • Alle, die in Agent-Clients arbeiten und den Agent Daten abfragen lassen wollen: gccli bringt einen fertigen Agent Skill mit, der laut offizieller Beschreibung auf KI-Agent-Clients wie Claude Code, Codex, Hermes und OpenClaw zielt.
  • Entwickler, die Workout- und Gesundheitsdaten in automatisierte Abläufe einbinden wollen.

Weniger geeignet, oder vorher klären:

  • Ohne Garmin-Connect-Konto geht es nicht: Die Authentifizierung läuft über Garmin SSO, das ist eine harte Voraussetzung.
  • Umgebungen ohne Homebrew: Der einzige kopierfertige Installationsbefehl der offiziellen Dokumentation ist Homebrew; ein Build aus dem Quellcode erfordert Go 1.26 oder höher, und vollständige Build-Schritte nennt das offizielle Repository nicht.
  • Die Client-Liste ist offiziell beispielhaft, nicht abschließend; zur Kompatibilität außerhalb der Liste gibt es keine Angabe — richte dich vor der Anbindung nach der Repository-Dokumentation.

Der erste Versuch in 3 Minuten

Es gibt genau einen empfohlenen Hauptweg: mit Homebrew installieren, die Garmin-SSO-Authentifizierung abschließen und den Agent dann eine Abfrage ausführen lassen.

Voraussetzungen: Du hast bereits ein Garmin-Connect-Konto; Homebrew ist auf deinem Rechner installiert; und du weißt, dass die erste Authentifizierung deine Zugangsdaten in den System-Keyring schreibt (Nebenwirkungen unter „Grenzen der Nutzung“).

Schritt 1, installieren:

brew install bpauli/tap/gccli

Schritt 2, authentifizieren. Die Authentifizierung läuft über Garmin SSO, die Zugangsdaten landen im System-Keyring. Ein Detail, das du vorher kennen musst: Wie die offizielle Dokumentation klar erklärt, verschlüsselt gccli jede Token-Datei mit einer festen Passphrase, die im Quellcode eingebettet ist — das betrifft die Fallback-Token-Datei, die greift, wenn der Keyring nicht verfügbar ist, und diese Passphrase ist kein Geheimnis, das nur dir gehört. Ob du diese Speicherart akzeptierst, entscheide vor der ersten Authentifizierung selbst. Einen konkreten Login-Befehl nennt die offizielle Dokumentation nicht; nach der Installation richtest du dich nach der eingebauten Hilfe von gccli.

Schritt 3, den Agent mit dem Skill verbinden. Der mitgelieferte Agent Skill liegt unter skills/gccli/SKILL.md und gilt laut offizieller Angabe als sofort einsatzbereit; wie du ihn an deinen konkreten Client anbindest, beschreibt die offizielle Dokumentation nicht — maßgeblich ist die Dokumentation des jeweiligen Clients.

Schritt 4, eine Abfrageaufgabe stellen. Sag dem Agent direkt: „Zeig mir meine letzten Laufaktivitäten und meine Körperzusammensetzungsdaten für diese Woche.“ Solche Aufgaben liegen innerhalb der offiziell gelisteten Datenzugriffs-Fähigkeiten; ob der Abfragevorgang lokale Dateien schreibt, ist offiziell nicht beschrieben und unbestätigt. Der einzige bestätigte Schreib-Nebeneffekt ist die Token-Speicherung (siehe „Grenzen der Nutzung“) — geh nicht davon aus, dass nur gelesen und nichts geschrieben wird.

Schritt 5, das Erfolgssignal prüfen: Die Antwort sollte parsebare Ausgabe im JSON- oder plain/TSV-Modus sein, die sich direkt einfügen oder an ein Skript übergeben lässt; sobald du strukturierte Ausgabe siehst, steht die Verbindung.

Anwendungsfälle

Fall 1: Workout- und Körperdaten zusammenfassen.

  • Szenario: Du willst die letzten Trainingseinheiten und die Gewichtsentwicklung auf einen Blick sehen, ohne dich durch die Weboberfläche zu klicken.
  • Aufruf: Sag in einem mit gccli verbundenen Agent-Client: „Liste meine letzten Workouts und Körperzusammensetzungsdaten auf.“
  • Ablauf: Der Agent greift über gccli auf Aktivitäten und Körperzusammensetzung zu, zwei offiziell bestätigte Datenkategorien.
  • Zu erwarten: parsebare JSON- oder plain/TSV-Ausgabe, die du in eine Tabelle einfügen oder an ein Skript übergeben kannst; eine Feldliste pro Datensatz nennt die offizielle Dokumentation nicht — die tatsächliche Antwort ist maßgeblich.

Fall 2: Garmin-Daten in Automatisierungsskripte einbinden.

  • Szenario: Du willst wöchentlich Geräte, Ausrüstung, Ziele und Abzeichen zusammenfassen und dein eigenes Trainingsarchiv aufbauen.
  • Aufruf: Rufe gccli aus bestehenden Skripten oder geplanten Agent-Jobs auf und gib die Ausgabe an die nächste Stufe weiter.
  • Ablauf: Nutze die offiziell betonte „skriptfreundliche“ Ausrichtung und die JSON- und plain/TSV-Ausgabemodi, um bestehende Abläufe anzubinden.
  • Zu erwarten: Maschinenlesbare Ausgabe fließt stabil in den nächsten Schritt; konkrete Subcommands und Parameter listen die offiziellen Unterlagen nicht wörtlich auf — wirf vor dem Start einen Blick in die gccli-Hilfe und die Repository-Dokumentation.

Grenzen der Nutzung

  • Netzwerk und Konto: Die Daten kommen aus der Garmin-Connect-Cloud; Authentifizierung und jede Abfrage brauchen eine Internetverbindung und dein Garmin-Konto. Eine Offline-Fähigkeit wird offiziell nicht erwähnt und ist unbestätigt.
  • Zugangsdaten und Schreib-Nebenwirkungen: Die erste Authentifizierung läuft über Garmin SSO und schreibt die Zugangsdaten in den System-Keyring; die Fallback-Token-Datei, die greift, wenn der Keyring nicht verfügbar ist, wird mit einer festen, im Quellcode eingebetteten Passphrase verschlüsselt. Ob Abfragen über die Token-Speicherung hinaus andere Dateien schreiben, ist offiziell nicht beschrieben und unbestätigt.
  • Laufzeitumgebung: Ein Build aus dem Quellcode erfordert Go 1.26 oder höher; der empfohlene Hauptweg läuft über Homebrew ohne lokalen Build. Andere Laufzeit-Anforderungen sind nicht dokumentiert.
  • Client-Voraussetzung: Der mitgelieferte Agent Skill zielt auf KI-Agent-Clients wie Claude Code, Codex, Hermes und OpenClaw; ob Clients außerhalb dieser Liste kompatibel sind und ob die Anbindungsschritte überall gleich ablaufen, wird offiziell nicht im Einzelnen beschrieben — prüfe vor der Anbindung die Dokumentation des jeweiligen Clients.
  • Explizite Grenzen: Zu Rate Limits, Export-Obergrenzen und Einschränkungen durch die Nutzungsbedingungen gibt es keine offiziellen Angaben; wirf vor massenhafter oder häufiger Nutzung einen Blick in das offizielle Repository.