withings-mcp

Servidor MCP para la API de salud de Withings con OAuth, caché local en SQLite y análisis de tendencias.

Qué hace que esto sea diferente de otros servidores MCP de Withings:

• Caché local en SQLite para consultas rápidas sin conexión y análisis de tendencias históricas

• Sincronización incremental: solo obtiene datos nuevos desde la última sincronización

• Soporte para los más de 200 tipos de mediciones de Withings (composición corporal, sueño, actividad, entrenamientos, ECG)

• Actualización automática de tokens OAuth (tokens de acceso: 3h, tokens de actualización: 1 año)

• Cero dependencias más allá de mcp (HTTP mediante biblioteca estándar)

• Python 3.13+

Herramientas

Related MCP server: Withings MCP Server

Requisitos previos

• Python 3.13+

• uv (recomendado) o pip

• Una cuenta de desarrollador de Withings y una aplicación registrada

Instalación

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

Configuración

1. Registrar una aplicación de Withings

1. Ve a https://developer.withings.com/dashboard

2. Crea una nueva aplicación

3. Establece la URL de devolución de llamada (callback URL) en http://localhost:8585

4. Anota tu Client ID y Client Secret

2. Autenticación

.venv/bin/withings-mcp auth

Esto abre tu navegador para la autorización de Withings. Después de aprobar, los tokens se guardan localmente en config/.

3. Registrar con Claude Code

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

4. Primera sincronización

En Claude Code, di: "Sync my Withings data"

Esto ejecuta withings_sync para completar la caché local. Las sincronizaciones posteriores solo obtienen datos nuevos.

Configuración

Ejemplos de 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"

Desarrollo

# 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

Seguridad

• Solo lectura: Ninguna herramienta modifica datos en los servidores de Withings

• Almacenamiento local: Los datos de salud permanecen en tu base de datos SQLite local

• Almacenamiento de tokens: Los tokens OAuth se almacenan en config/ (ignorado por git, permisos de archivo 0600)

• Mensajes de error: Nunca contienen valores de datos de salud, solo códigos de estado

• Hook de pre-commit: Rechaza archivos de base de datos y credenciales en los commits

Contribución

Consulta CONTRIBUTING.md para la configuración del desarrollo, el flujo de trabajo de pruebas y el hook de pre-commit. Los cambios se registran en CHANGELOG.md.

Licencia

GPL-3.0-or-later