Garmin Connect China MCP

Ein lokaler, schreibgeschützter MCP-Server für ein China-Region-Garmin-Connect-Konto. Jeder Garmin-Client ist fest an garmin.cn gebunden; API-Lesezugriffe gehen an https://connectapi.garmin.cn und die entsprechenden China-SSO/DI-Auth-Hosts.

Dies verwendet die inoffizielle Consumer-Web-API von Garmin Connect über garminconnect. Es ist für den privaten persönlichen Gebrauch geeignet, kann brechen, wenn Garmin seine Dienste ändert, und ist kein Ersatz für die genehmigte Garmin Health API für kommerzielle Produkte.

Requirements

• Python 3.12+

• uv

• Ein Garmin Connect China-Konto

Related MCP server: health-mcp

Install and authenticate

Aus diesem Verzeichnis:

uv sync
uv run garmin-cn-auth

Der Auth-Befehl fragt E-Mail, Passwort und MFA direkt im Terminal ab. Passwörter und MFA-Codes werden niemals zu MCP-Argumenten. Aktualisierbare Token werden standardmäßig unter ~/.config/garmin-cn-mcp/ mit Berechtigungen nur für den Besitzer gespeichert.

Behandeln Sie dieses Token-Verzeichnis wie ein Passwort. Falls es möglicherweise kopiert wurde, entfernen Sie es und widerrufen Sie den Kontozugriff in den Konto-/Sicherheitseinstellungen von Garmin.

Add to Codex / ChatGPT desktop

Mit Codex CLI:

codex mcp add garmin-cn -- \
  uv --directory /absolute/path/to/garmincn-mcp run garmin-cn-mcp

Oder fügen Sie dies zu ~/.codex/config.toml hinzu:

[mcp_servers.garmin-cn]
command = "uv"
args = [
  "--directory",
  "/absolute/path/to/garmincn-mcp",
  "run",
  "garmin-cn-mcp",
]
startup_timeout_sec = 20
tool_timeout_sec = 60

Die ChatGPT-Desktop-App, Codex CLI und die Codex-IDE-Erweiterung teilen sich die MCP-Konfiguration für denselben Codex-Host. In ChatGPT Desktop können Sie auch Einstellungen → MCP-Server → Server hinzufügen öffnen, STDIO auswählen und denselben Befehl verwenden. Starten Sie den Client nach dem Hinzufügen neu und verwenden Sie dann /mcp, um zu bestätigen, dass garmin-cn verbunden ist.

ChatGPT Web liest keine lokale Codex-MCP-Konfiguration. Die Webnutzung würde ein separat gehostetes Remote-MCP/Plugin mit einer Mehrbenutzer-Autorisierungs- und Datenschutzarchitektur erfordern; das ist bewusst außerhalb dieses Projekts.

Tools

• get_connection_status

• get_daily_summary

• get_sleep

• get_heart_rate

• get_hrv

• get_training_readiness

• get_morning_training_readiness

• get_body_battery

• list_activities

• get_activity_details

• get_activity_exercise_sets

• get_activity_supplementary

Jedes Tool ist schreibgeschützt und nicht destruktiv. Datumsbereiche sind auf 31 Tage begrenzt und Aktivitätslisten auf 100 Ergebnisse. Es wird kein roher API-Pfad- oder Garmin-Schreib-Tool bereitgestellt.

Custom token-store path

Setzen Sie GARMIN_CN_TOKEN_STORE für sowohl Auth- als auch MCP-Prozesse, oder übergeben Sie --token-store an einen der beiden Befehle. Halten Sie den Pfad außerhalb eines Git-Repositorys.

Development checks

uv sync --group dev
uv run pytest
uv run ruff check .
uv run mypy

Tests verwenden fabrizierte Anbieter und kontaktieren niemals Garmin.