davidmosiah avatar

Withingsmcp

davidmosiah/withings-mcp

Connects Claude to your Withings body composition scales, sleep trackers, and activity data through the official Withings Public API. Handles the signed OAuth flow locally so tokens never leave your machine. Exposes tools for body measures (weight, fat percentage, muscle mass), sleep summaries with stages and heart rate, daily activity totals, and workout logs. Ships with daily and weekly summary tools plus investigation prompts that correlate body composition changes with sleep patterns. Defaults to structured responses but can return raw Withings JSON when you need it. Built for people tracking long term health trends in their AI workflows without copy pasting numbers from the Withings app.

GitHub stars
5
tools
17
auth
Secret needed
transport
STDIO
env vars
8
last updated
Jul 3, 2026

Tools

17 tools

Public tool metadata for what this MCP can expose to an agent.

withings_connection_statusverify local setup before calling Withings

verify local setup before calling Withings

No parameter schema in public metadata yet.

withings_data_inventoryinventory supported data domains, scopes, privacy modes and recommended first calls without calling Withings APIs.

inventory supported data domains, scopes, privacy modes and recommended first calls without calling Withings APIs.

No parameter schema in public metadata yet.

withings_daily_summarybody, sleep, activity and heart brief for today

body, sleep, activity and heart brief for today

No parameter schema in public metadata yet.

withings_weekly_summaryscorecard, comparison vs prior week, next-week plan

scorecard, comparison vs prior week, next-week plan

No parameter schema in public metadata yet.

withings_capabilities

No parameter schema in public metadata yet.

withings_agent_manifest

No parameter schema in public metadata yet.

withings_privacy_audit

No parameter schema in public metadata yet.

withings_cache_status

No parameter schema in public metadata yet.

withings_get_auth_url

No parameter schema in public metadata yet.

withings_exchange_code

No parameter schema in public metadata yet.

withings_revoke_access

No parameter schema in public metadata yet.

withings_list_body_measurespunctual weight/composition records.

punctual weight/composition records.

No parameter schema in public metadata yet.

withings_list_heartheart records when device/plan permit

heart records when device/plan permit

No parameter schema in public metadata yet.

withings_list_activitydaily activity summaries

daily activity summaries

No parameter schema in public metadata yet.

withings_list_workoutslogged workouts

logged workouts

No parameter schema in public metadata yet.

withings_list_sleep_summarydaily sleep summaries with HR/stage fields

daily sleep summaries with HR/stage fields

No parameter schema in public metadata yet.

withings_list_sleepdetailed sleep records

detailed sleep records

No parameter schema in public metadata yet.

Sponsors

Configuration

WITHINGS_CLIENT_ID

Withings OAuth client ID. Optional when configured with withings-mcp-server setup.

WITHINGS_CLIENT_SECRETsecret

Withings OAuth client secret. Prefer withings-mcp-server setup so this secret is stored in ~/.withings-mcp/config.json instead of MCP client config.

WITHINGS_REDIRECT_URI

Redirect URI configured in the Withings Developer Dashboard. Optional when configured with withings-mcp-server setup.

WITHINGS_TOKEN_PATH

Optional local path for OAuth tokens. Defaults to ~/.withings-mcp/tokens.json.

WITHINGS_PRIVACY_MODE

Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full Withings API payloads, not continuous 24/7 raw sensor telemetry.

WITHINGS_CACHE

Optional SQLite cache toggle. Set to true or sqlite to enable.

WITHINGS_CACHE_PATH

Optional local SQLite cache path. Defaults to ~/.withings-mcp/cache.sqlite.

WITHINGS_NO_CACHE

Set to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless. Note: Withings's wbsapi.withings.net is POST-only today, so this is currently a no-op.

Readme

Upgrading to 0.6.0: read the migration guide for local-only HTTP, disabled authenticated-response caching, and stricter input/profile limits.

Withings MCP

Withings MCP — Withings MCP for AI agents

Give your AI agent your Withings body measures, sleep, activity and heart data — locally.
Local-first MCP server — tokens never leave your machine.


View the full README on GitHub

Details

Repository
github.com/davidmosiah/withings-mcp
Website
wellness.delx.ai/connectors/withings
Package
withings-mcp-unofficial
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from davidmosiah