withings-mcp

OAuth, 로컬 SQLite 캐시 및 추세 분석 기능을 갖춘 Withings Health API용 MCP 서버입니다.

다른 Withings MCP 서버와의 차별점:

• 빠른 오프라인 쿼리 및 과거 추세 분석을 위한 로컬 SQLite 캐시

• 증분 동기화 - 마지막 동기화 이후의 새로운 데이터만 가져옴

• 200개 이상의 모든 Withings 측정 유형 지원 (신체 구성, 수면, 활동, 운동, ECG)

• 자동 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을 http://localhost:8585로 설정

4. 클라이언트 ID와 클라이언트 시크릿을 기록

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/에 저장됩니다 (gitignored, 파일 권한 0600).

• 오류 메시지: 건강 데이터 값을 포함하지 않으며 상태 코드만 포함합니다.

• Pre-commit 훅: 커밋에서 데이터베이스 파일 및 자격 증명을 거부합니다.

기여

개발 설정, 테스트 워크플로우 및 pre-commit 훅에 대해서는 CONTRIBUTING.md를 참조하세요. 변경 사항은 CHANGELOG.md에서 추적됩니다.

라이선스

GPL-3.0-or-later