Withings MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WITHINGS_CACHE | No | Cache backend (e.g., sqlite). | sqlite |
| WITHINGS_SCOPES | No | Space-separated list of OAuth scopes. | user.activity user.metrics |
| WITHINGS_CLIENT_ID | Yes | Your Withings client ID from the OAuth2 dashboard. | |
| WITHINGS_CACHE_PATH | No | Path for cache database. | ~/.withings-mcp/cache.sqlite |
| WITHINGS_TOKEN_PATH | No | Path to store OAuth tokens. | ~/.withings-mcp/tokens.json |
| WITHINGS_PRIVACY_MODE | No | Privacy mode: summary, structured, or raw. | structured |
| WITHINGS_REDIRECT_URI | Yes | Redirect URI registered with Withings. | http://127.0.0.1:3000/callback |
| WITHINGS_CLIENT_SECRET | Yes | Your Withings client secret. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| withings_data_inventoryA | Inventory supported Withings data domains, auth scope requirements, privacy boundary and recommended first calls. Does not call Withings APIs or expose user data. |
| withings_agent_manifestA | Machine-readable install, runtime and client guidance for AI agents. Does not call Withings or expose secrets. |
| withings_capabilitiesA | Explain supported Withings data, privacy boundaries, recommended agent workflow and project links. |
| withings_quickstartA | Personalized 3-step setup walkthrough for the human user. Adapts to current state (env vars set? token present? what's next?). Call this first when the user asks 'how do I connect Withings?' |
| withings_demoA | Returns realistic example payloads of withings_daily_summary, withings_wellness_context, and withings_list_body_measures so agents see the contract before calling real Withings APIs. |
| withings_get_auth_urlA | Generate a Withings OAuth authorization URL. Use this first when no local token exists. |
| withings_exchange_codeA | Exchange a Withings OAuth authorization code for local tokens using Withings signed request flow. Tokens are stored locally and never returned. |
| withings_list_body_measuresA | List Withings punctual measurements such as weight and body composition. Requires user.metrics scope. Not medical advice. |
| withings_list_activityC | List Withings daily activity summaries. Requires user.activity scope. |
| withings_list_workoutsB | List Withings workouts. Requires user.activity scope. |
| withings_list_sleep_summaryA | List Withings sleep summaries with common sleep fields. Requires user.activity scope. Not medical advice. |
| withings_list_sleepB | List detailed Withings sleep data where available. Requires user.activity scope. Not medical advice. |
| withings_list_heartB | List Withings heart records where available. Requires user.metrics scope. Not medical advice. |
| withings_connection_statusA | Check local Withings config, token file, Node version, privacy mode, cache readiness and optional MCP client readiness without calling Withings or exposing secrets. |
| withings_cache_statusA | Show optional local SQLite cache status. Enable with WITHINGS_CACHE=sqlite or WITHINGS_CACHE=true. |
| withings_privacy_auditA | Return local privacy, cache, token-path and env-presence posture without revealing secret values. |
| withings_revoke_accessA | Delete the local Withings token file. Withings token revocation support varies by app/API plan, so this tool only clears local access. |
| withings_daily_summaryB | Build a practical daily summary from Withings activity, sleep and body/heart data when available. Read-only and non-medical. |
| withings_weekly_summaryA | Build a weekly Withings scorecard with sleep, activity, body measures, bottlenecks and actions. Read-only and non-medical. |
| withings_wellness_contextA | Normalize Withings sleep and activity load into the shared wellness_context shape for recommendation engines. |
| withings_profile_getA | Read the shared Delx Wellness profile from ~/.delx-wellness/profile.json. Returns preferred name, goals, devices, training/nutrition/exercise/agent preferences and safety flags. NEVER contains OAuth tokens or API secrets. Read-only. |
| withings_profile_updateA | Persist a partial patch to ~/.delx-wellness/profile.json. Requires explicit_user_intent=true (otherwise returns USER_ACTION_REQUIRED). Rejects secret-like fields (oauth, token, secret, password, cookie, refresh, api_key, session) at write time. Use to record preferred name, goals, devices, training context, nutrition context, exercise preferences, agent preferences, and safety flags. |
| withings_onboardingA | Return the 11-question onboarding flow plus the current profile state and missing fields. Read-only — does NOT persist anything. Pair with withings_profile_update once the user answers. Cross-connector: the same profile is shared by every Delx Wellness MCP (whoop, garmin, oura, fitbit, strava, polar, withings, apple-health, samsung-health, google-health, nourish, cycle-coach, cgm, air). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| withings_daily_checkin | Ask an agent to create a practical daily health and training check-in from Withings. |
| withings_weekly_review | Ask an agent to review Withings trends across activity, sleep and heart context. |
| withings_body_sleep_investigation | Investigate Withings body measures and adjacent sleep context. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| withings_data_inventory | Static inventory of supported Withings data domains, privacy modes and recommended first calls. |
| withings_capabilities | Static capabilities, API boundary, privacy modes and recommended agent workflow. |
| withings_agent_manifest | Machine-readable install and operating instructions for AI agents. |
| withings_latest_activity | Most recent Withings activity record in the configured privacy mode. |
| withings_latest_sleep | Most recent Withings sleep summary in the configured privacy mode. |
| withings_daily_summary | Daily Withings health summary built from API data. |
| withings_weekly_summary | Weekly Withings health review built from API data. |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/davidmosiah/withings-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server