Garmin Connect für Claude

Fragen Sie Claude auf Deutsch nach Ihren Garmin-Daten.

„Wie habe ich letzte Nacht geschlafen?“ „Zeig mir meine Läufe der letzten zwei Wochen.“ „Bin ich genug erholt, um heute hart zu trainieren?“ „Wie viel bin ich letzten Monat im Vergleich zum Vormonat gelaufen?“

Dies verbindet Ihr Garmin Connect-Konto mit der Claude Desktop-App, sodass Claude Ihre Workouts, Schlaf, Herzfrequenz und andere Gesundheitsdaten lesen und mit Ihnen darüber sprechen kann.

Sie müssen nicht programmieren können, um dies zu nutzen. Der Installer stellt Ihnen ein paar Fragen und erledigt den Rest.

Was Sie brauchen

• Einen Mac

• Die Claude Desktop-App

• Ein Garmin Connect-Konto mit einer Garmin-Uhr oder einem Garmin-Gerät

Related MCP server: Garmin Connect MCP Server

Installation

Öffnen Sie die Terminal-App auf Ihrem Mac. (Drücken Sie Cmd + Leertaste, geben Sie Terminal ein, drücken Sie die Eingabetaste.)

Kopieren Sie diese Zeile, fügen Sie sie in das Terminal-Fenster ein und drücken Sie die Eingabetaste:

curl -fsSL https://raw.githubusercontent.com/jharkebusch/garmin-connect-mcp/main/install.sh | bash

Es wird:

1. Eine private, in sich geschlossene Python-Umgebung einrichten (Ihr Mac-eigenes Python wird nicht berührt)

2. Nach Ihrer Garmin-E-Mail und Ihrem Passwort sowie dem Sicherheitscode fragen, den Garmin Ihnen sendet

3. Claude Desktop für Sie konfigurieren

Wenn es fertig ist, beenden Sie Claude Desktop vollständig mit Cmd + Q und öffnen Sie es erneut. Das Schließen des Fensters reicht nicht.

Dann fragen Sie Claude einfach nach Ihren Garmin-Daten.

Was Claude tun kann

Gesundheit und Wohlbefinden

Workouts und Aktivitäten

Dinge aufzeichnen (diese ändern Ihr Garmin-Konto)

Nichts kann Ihre Daten löschen. Es gibt kein Tool, das eine Aktivität, ein Workout oder eine Gewichtsmessung entfernt, sodass eine versehentliche Anfrage Ihre Trainingshistorie nicht zerstören kann.

Datumsangaben in einfachem Deutsch

Jedes Tool versteht alltägliche Ausdrücke, sodass Sie einfach normal sprechen können:

heute · gestern · letzte Nacht · vor 3 Tagen · letzte 7 Tage · diese Woche · letzten Monat · 2026-08-18 · 2026-08-01 bis 2026-08-18

Ihre Privatsphäre und Sicherheit

• Ihr Passwort wird niemals gespeichert. Es wird einmal während der Einrichtung zum Anmelden verwendet und dann verworfen.

• Nur die Zugriffstoken von Garmin werden gespeichert, in ~/.garminconnect, als eine Datei, die nur Ihr Benutzerkonto lesen kann (0600, in einem 0700-Ordner).

• Es wird nichts außer an Garmin gesendet. Es gibt keine Telemetrie, keine Analysen und keinen Drittanbieter-Server. Ihre Daten gehen von Garmin zu Ihrem eigenen Mac und nirgendwo anders hin.

• Alles läuft lokal auf Ihrem Rechner.

• Ihre Garmin-Daten gelangen nur dann zu Anthropic, wenn Claude sie in eine Antwort einbezieht, genau wie alles andere, was Sie in Claude eingeben.

Aktualisieren

Führen Sie denselben Installationsbefehl erneut aus. Es aktualisiert an Ort und Stelle und hält Sie angemeldet.

Falls Sie sich erneut anmelden müssen

Garmin-Sitzungen erneuern sich selbst und laufen selten ab. Falls Claude jemals sagt, dass Ihre Anmeldung abgelaufen ist, führen Sie dies im Terminal aus:

garmin-mcp-setup

Wenn Ihr Terminal diesen Befehl nicht erkennt, verwenden Sie den vollständigen Pfad:

~/.garmin-mcp/bin/garmin-mcp-setup

Deinstallieren

rm -rf ~/.garmin-mcp ~/.garminconnect ~/.local/bin/garmin-mcp-setup

Entfernen Sie dann den Eintrag "garmin" aus dem Abschnitt mcpServers von ~/Library/Application Support/Claude/claude_desktop_config.json.

Fehlerbehebung

Claude sieht die Garmin-Tools nicht. Beenden Sie Claude Desktop vollständig mit Cmd + Q und öffnen Sie es erneut. Das Schließen des Fensters lässt es im Hintergrund laufen.

„Ihr Garmin-Konto ist noch nicht verbunden.“ Führen Sie garmin-mcp-setup im Terminal aus.

„Zu viele Anfragen.“ Garmin begrenzt die Anzahl der Anmeldeversuche. Warten Sie etwa 15 Minuten.

Eine Zahl fehlt in einer Antwort. Fehlend bedeutet, dass Ihr Gerät sie nicht aufgezeichnet hat. Einige Metriken (HRV, Body Battery, Trainingsbereitschaft) benötigen eine kompatible Garmin-Uhr, die über Nacht getragen wird. Die Tools lassen eine Metrik weg, anstatt einen Wert zu schätzen.

Für Entwickler

git clone https://github.com/jharkebusch/garmin-connect-mcp.git
cd garmin-connect-mcp
uv venv --python 3.12 && VIRTUAL_ENV=.venv uv pip install -e ".[dev]"
VIRTUAL_ENV=.venv uv run pytest

Aufbau:

• src/garmin_mcp/server.py — MCP-Server und Tool-Registrierung

• src/garmin_mcp/session.py — authentifizierter Garmin-Client, Thread-Auslagerung

• src/garmin_mcp/dates.py — Datumsanalyse in einfachem Deutsch

• src/garmin_mcp/format.py — kürzt Garmin-JSON zu lesbarem Text

• src/garmin_mcp/tools/ — die Tools selbst

• src/garmin_mcp/setup_cli.py — interaktive Anmeldung und Claude-Konfiguration

Zwei Designhinweise:

• garminconnect ist synchron, daher wird jeder Aufruf in einen Worker-Thread verschoben. Andernfalls würde eine langsame Garmin-Anfrage den gesamten Server blockieren.

• Die Anmeldung kann nicht innerhalb eines Tool-Aufrufs erfolgen, da der zweistufige Authentifizierungsschritt von Garmin eine interaktive Eingabeaufforderung benötigt. Das Setup schreibt eine Token-Datei; der Server liest sie nur.

Ein erwähnenswerter Vorbehalt

Garmin veröffentlicht keine öffentliche API. Dies verwendet dieselbe Schnittstelle, die die Garmin-Mobil-App verwendet, über die garminconnect-Bibliothek. Es funktioniert gut, aber Garmin kann diese Schnittstelle jederzeit ändern und Drittanbieter-Tools vorübergehend lahmlegen. Wenn das passiert, behebt das erneute Ausführen des Installers das Problem, sobald die zugrundeliegende Bibliothek einen Fix bereitstellt.

Dieses Projekt ist nicht mit der Garmin Ltd. verbunden, wird von ihr nicht unterstützt und steht in keiner Verbindung zu ihr. Verwenden Sie es mit Ihrem eigenen Konto und Ihren eigenen Daten.

Lizenz

MIT — siehe LICENSE.