withings-mcp

MCP-Server für die Withings Health API mit OAuth, lokalem SQLite-Cache und Trendanalyse.

Was diesen Server von anderen Withings-MCP-Servern unterscheidet:

• Lokaler SQLite-Cache für schnelle Offline-Abfragen und historische Trendanalysen

• Inkrementelle Synchronisierung – ruft nur neue Daten seit der letzten Synchronisierung ab

• Unterstützung für alle über 200 Withings-Messtypen (Körperzusammensetzung, Schlaf, Aktivität, Workouts, EKG)

• Automatische OAuth-Token-Aktualisierung (Zugriffstoken: 3 Std., Aktualisierungstoken: 1 Jahr)

• Keine Abhängigkeiten außer mcp (HTTP über Standardbibliothek)

• Python 3.13+

Tools

Related MCP server: Withings MCP Server

Voraussetzungen

• Python 3.13+

• uv (empfohlen) oder pip

• Ein Withings-Entwicklerkonto und eine registrierte Anwendung

Installation

git clone https://github.com/partymola/withings-mcp.git
cd withings-mcp
uv venv --python 3.13 .venv
uv pip install -e .

Einrichtung

1. Registrieren einer Withings-App

1. Gehen Sie zu https://developer.withings.com/dashboard

2. Erstellen Sie eine neue Anwendung

3. Setzen Sie die Callback-URL auf http://localhost:8585

4. Notieren Sie sich Ihre Client-ID und Ihr Client-Secret

2. Authentifizierung

.venv/bin/withings-mcp auth

Dies öffnet Ihren Browser für die Withings-Autorisierung. Nach der Bestätigung werden die Token lokal in config/ gespeichert.

3. Registrierung bei Claude Code

claude mcp add -s user withings -- /path/to/withings-mcp/.venv/bin/withings-mcp

4. Erste Synchronisierung

Sagen Sie in Claude Code: "Sync my Withings data"

Dies führt withings_sync aus, um den lokalen Cache zu füllen. Nachfolgende Synchronisierungen rufen nur neue Daten ab.

Konfiguration

Beispiel-Prompts

• "Sync my Withings data"

• "Show my weight for the last 3 months"

• "How has my sleep changed this year?"

• "Compare my body composition this month vs last month"

• "What workouts did I do in March?"

• "What Withings devices do I have connected?"

• "Show my sleep trends quarterly"

Entwicklung

# Install with dev dependencies
uv pip install -e . && uv pip install pytest

# Run tests (74 tests, all use in-memory SQLite with fictional data)
.venv/bin/python -m pytest tests/ -v

Sicherheit

• Schreibgeschützt: Keine Tools verändern Daten auf den Withings-Servern

• Lokale Speicherung: Gesundheitsdaten verbleiben in Ihrer lokalen SQLite-Datenbank

• Token-Speicherung: OAuth-Token werden in config/ gespeichert (gitignored, Dateiberechtigungen 0600)

• Fehlermeldungen: Enthalten niemals Gesundheitsdaten – nur Statuscodes

• Pre-commit-Hook: Verhindert das Committen von Datenbankdateien und Anmeldedaten

Mitwirken

Siehe CONTRIBUTING.md für die Entwicklungseinrichtung, den Test-Workflow und den Pre-commit-Hook. Änderungen werden in CHANGELOG.md protokolliert.

Lizenz

GPL-3.0-or-later