Garmin mit Gemini verbinden

garmlink einrichten in

Gemini erreicht garmlink über das Model Context Protocol (MCP) auf drei Wegen: als benutzerdefinierte App in der Gemini-App im Web, über die Gemini CLI für Einzelpersonen oder in Gemini Enterprise für Organisationen. Diese Anleitung deckt alle drei ab.

Bevor du loslegst Du brauchst ein garmlink-Konto mit verbundenem Garmin (das machst du auf dem Bildschirm „Verbindung“) – und die Gemini-App im Web, die Gemini CLI auf deinem Rechner oder ein Gemini-Enterprise-Workspace.
  1. Garmin-Konto verbinden

    Auf dem Bildschirm „Verbindung“, melde dich mit deiner E-Mail-Adresse und deinem Passwort bei Garmin Connect an (einmal verwendet, nie gespeichert), gib den Bestätigungscode ein, falls Garmin einen verlangt, und warte auf den Status Verbunden. garmlink beginnt sofort, deine Aktivitäten, deinen Schlaf, deine HRV und deine Trainingskennzahlen zu synchronisieren.

Weg A – Gemini-App (Web)

Google führt benutzerdefinierte Apps schrittweise ein: Vorerst erscheinen sie bei persönlichen Google-Konten in den USA, ab 18 Jahren, mit Gemini auf Englisch und eingeschalteter Keep Activity. Siehst du sie noch nicht? Weg B funktioniert überall.

  1. 2.

    garmlink als benutzerdefinierte App hinzufügen

    Öffne auf gemini.google.com Einstellungen, dann Verbundene Apps und Benutzerdefinierte Apps. Füge die garmlink-Adresse ein und klick auf Weiter:https://api.garmlink.ai/mcp

    Gemini öffnet die garmlink-Anmeldeseite: Melde dich an und drück auf Autorisieren.

  2. 3.

    garmlink in einem Chat aufrufen

    Tippe in einer Unterhaltung @, wähle garmlink und frag dann:
    • „Wie habe ich diese Woche geschlafen?“
    • „Fasse meine letzten fünf Läufe zusammen.“
    • „Steigt oder sinkt meine Trainingsbelastung in diesem Monat?“

Weg B – Gemini CLI (einzeln)

  1. 4.

    Gemini CLI installieren

    Installiere die CLI global und führe sie einmal aus, damit sie ihr Konfigurationsverzeichnis anlegt:
    • npm install -g @google/gemini-cli
    • gemini

    Melde dich mit deinem Google-Konto an, wenn danach gefragt wird.

  2. 5.

    garmlink in den CLI-Einstellungen eintragen

    Öffne ~/.gemini/settings.json (leg sie an, falls sie nicht existiert) und trage garmlink als MCP-Server ein:
    {
      "mcpServers": {
        "garmlink": {
          "httpUrl": "https://api.garmlink.ai/mcp",
          "oauth": { "enabled": true }
        }
      }
    }

    Mehr kommt nicht in diese Datei – keine Header, kein API-Schlüssel, kein Client-Secret. Bei aktiviertem OAuth führt die Gemini CLI den gesamten OAuth-2.0-Ablauf selbst durch.

  3. 6.

    CLI starten und Zugriff freigeben

    Starte gemini in einem Terminal. Beim ersten Zugriff auf garmlink öffnet sich ein Browserfenster: Melde dich an, gib den Lesezugriff frei, und die CLI speichert die Tokens lokal für das nächste Mal.

    Frag dann einfach in normaler Sprache:

    • „Wie habe ich diese Woche geschlafen?“
    • „Fasse meine letzten fünf Läufe zusammen.“
    • „Steigt oder sinkt meine Trainingsbelastung in diesem Monat?“

Weg C – Gemini Enterprise (Organisation)

  1. 7.

    MCP-Server in Gemini Enterprise hinzufügen

    Öffne in Gemini Enterprise Connected apps → Add MCP Server. Trag die Angaben zum MCP-Server ein – einen Namen, eine Beschreibung und die garmlink-URL:https://api.garmlink.ai/mcp

    Nur der Transport StreamableHTTP wird unterstützt – ältere SSE-MCP-Server werden abgelehnt. garmlink nutzt StreamableHTTP und erfüllt die Voraussetzung also.

    Symbol (optional)

    PNG, 256×256, ≤ 10 KB. Das garmlink-Symbol bringt seinen eigenen Hintergrund mit und bleibt deshalb lesbar, egal ob die Oberfläche des Assistenten hell oder dunkel ist.

    Das garmlink-Connector-Symbol
    Auf heller Oberfläche
    Das garmlink-Connector-Symbol
    Auf dunkler Oberfläche
    Symbol herunterladen
  2. 8.

    Authentifizieren und Geltungsbereich festlegen

    Wähle OAuth als Authentifizierungsmethode und schließe die garmlink-Anmeldung ab. Wähle dann den Geltungsbereich: die Verbindung für die ganze Organisation veröffentlichen oder jedes Mitglied mit seinem eigenen garmlink-Konto authentifizieren lassen.
Fehlerbehebung
  • In der Gemini-App gibt es keine Option „Benutzerdefinierte Apps“. Dein Konto hat noch keine benutzerdefinierten Apps – Google öffnet sie zuerst für persönliche Konten in den USA, auf Englisch. Nutz in der Zwischenzeit die Gemini CLI oder Gemini Enterprise, falls deine Organisation es hat.
  • Die CLI kann sich nicht authentifizieren. Stell sicher, dass ~/.gemini/settings.json keinen Header und kein Token neben dem OAuth-Block enthält – ein veralteter Authorization-Header hat Vorrang vor dem OAuth-Ablauf, und der Server antwortet mit 401.
  • Der Server ist nicht erreichbar. Die MCP-URL muss von dem Rechner, auf dem die CLI läuft (oder von Gemini Enterprise), über HTTPS erreichbar sein – prüf, dass kein Proxy oder keine Firewall sie blockiert.
  • Daten wirken leer oder veraltet. Prüf auf dem Bildschirm „Verbindung“.

Du nutzt einen anderen Assistenten? Sieh dir an: alle Anleitungen. Neugierig, was garmlink lesen kann? Stöbere in der Tool-Referenz. Du willst zuerst echte Antworten sehen? Lies zwölf Beispiele aus einem echten Konto.