withings-mcp

MCP-сервер для Withings Health API с поддержкой OAuth, локальным кэшем SQLite и анализом трендов.

Чем этот сервер отличается от других MCP-серверов Withings:

• Локальный кэш SQLite для быстрых офлайн-запросов и анализа исторических трендов

• Инкрементальная синхронизация — загружаются только новые данные с момента последней синхронизации

• Поддержка всех 200+ типов измерений Withings (состав тела, сон, активность, тренировки, ЭКГ)

• Автоматическое обновление токенов OAuth (токены доступа: 3 часа, токены обновления: 1 год)

• Отсутствие зависимостей, кроме mcp (HTTP через стандартную библиотеку)

• Python 3.13+

Инструменты

Related MCP server: Withings MCP Server

Предварительные требования

• Python 3.13+

• uv (рекомендуется) или pip

• Учетная запись разработчика Withings и зарегистрированное приложение

Установка

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

Настройка

1. Регистрация приложения Withings

1. Перейдите на https://developer.withings.com/dashboard

2. Создайте новое приложение

3. Установите URL обратного вызова (callback URL) на http://localhost:8585

4. Сохраните ваш Client ID и Client Secret

2. Аутентификация

.venv/bin/withings-mcp auth

Это откроет ваш браузер для авторизации в Withings. После подтверждения токены будут сохранены локально в папке config/.

3. Регистрация в Claude Code

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

4. Первая синхронизация

В Claude Code введите: "Sync my Withings data"

Это запустит withings_sync для заполнения локального кэша. Последующие синхронизации будут загружать только новые данные.

Конфигурация

Примеры запросов

• "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"

Разработка

# 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

Безопасность

• Только чтение: Инструменты не изменяют данные на серверах Withings

• Локальное хранилище: Данные о здоровье остаются в вашей локальной базе данных SQLite

• Хранение токенов: Токены OAuth хранятся в config/ (игнорируется git, права доступа к файлам 0600)

• Сообщения об ошибках: Никогда не содержат значений данных о здоровье — только коды состояния

• Pre-commit hook: Отклоняет файлы баз данных и учетные данные при коммитах

Участие в разработке

См. CONTRIBUTING.md для настройки среды разработки, рабочего процесса тестирования и pre-commit hook. Изменения отслеживаются в CHANGELOG.md.

Лицензия

GPL-3.0-or-later