Skip to main content
Glama
madebydia

withings-mcp

by madebydia
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

withings-mcp

Read-only Model Context Protocol server for Withings weight and body-composition history. It uses Withings' OAuth 2.0 web flow, refreshes rotating tokens automatically, and persists tokens in a private file (use a Railway volume in production).

Tools

  • get_measurements: normalized measurements for an inclusive date range.

  • get_weight_history: weight-focused history with kilograms and pounds.

  • get_latest_measurement: most recent weight/body-composition group.

  • get_authorization_status: configuration and authorization state without secrets.

Supported scale metrics include weight, fat-free mass, fat ratio, fat mass, muscle mass, hydration, bone mass, visceral fat, basal metabolic rate, and metabolic age. Availability depends on the scale model and the data Withings returned.

Related MCP server: Withings MCP Client

Environment

Variable

Purpose

WITHINGS_CLIENT_ID

Withings developer application client ID

WITHINGS_CLIENT_SECRET

Withings developer application secret

WITHINGS_REDIRECT_URI

Exact OAuth callback URI registered with Withings

WITHINGS_TOKEN_FILE

Persistent token path; defaults to /data/withings-token.json

MCP_AUTH_TOKEN

Bearer token required by /mcp

The service exposes /healthz, /oauth/start, /oauth/callback, and the protected /mcp endpoint. Starting OAuth does not expose data; the callback requires a short-lived Withings code and a one-time server-side state value. Measurement reads still require the separate MCP bearer token.

Local test

python3 -m venv .venv
.venv/bin/pip install --require-hashes -r requirements-dev.lock
.venv/bin/pytest

Railway

Mount a volume at /data, set the six variables above, and register this callback in the Withings developer dashboard:

https://<service-domain>/oauth/callback

After authorization, connect an MCP client to https://<service-domain>/mcp with Authorization: Bearer <MCP_AUTH_TOKEN>.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Oura Ring MCP Server

    JamesLouie
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides access to Oura Ring health and fitness data through the Oura API v2, enabling retrieval of sleep, activity, readiness, and other health metrics.
    122 npm
    2
    MIT

  • Withings MCP Client

    gchallen
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables retrieval of health data from Withings smart scales including weight measurements and comprehensive body composition metrics like fat mass, muscle mass, and hydration levels. Supports multiple users, unit preferences, and OAuth authentication for secure access to personal health data.
    2
    -

  • withings-mcp

    partymola
    A
    license
    A
    quality
    A
    maintenance
    Provides read-only access to Withings health metrics including body composition, sleep, workouts, and ECG data with local SQLite caching and trend analysis. Features incremental synchronization, automatic OAuth token refresh, and supports all 200+ Withings measurement types for comprehensive health tracking.
    8
    54 PyPI
    GPL 3.0

  • Withings MCP Server

    akutishevsky
    A
    license
    Not graded
    quality
    A
    maintenance
    A Model Context Protocol (MCP) server that brings your Withings health data into Claude, allowing natural conversation access to sleep patterns, body measurements, workouts, heart data, and more.
    42
    MIT