Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WITHINGS_CACHENoCache backend (e.g., sqlite).sqlite
WITHINGS_SCOPESNoSpace-separated list of OAuth scopes.user.activity user.metrics
WITHINGS_CLIENT_IDYesYour Withings client ID from the OAuth2 dashboard.
WITHINGS_CACHE_PATHNoPath for cache database.~/.withings-mcp/cache.sqlite
WITHINGS_TOKEN_PATHNoPath to store OAuth tokens.~/.withings-mcp/tokens.json
WITHINGS_PRIVACY_MODENoPrivacy mode: summary, structured, or raw.structured
WITHINGS_REDIRECT_URIYesRedirect URI registered with Withings.http://127.0.0.1:3000/callback
WITHINGS_CLIENT_SECRETYesYour Withings client secret.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
withings_daily_checkinAsk an agent to create a practical daily health and training check-in from Withings.
withings_weekly_reviewAsk an agent to review Withings trends across activity, sleep and heart context.
withings_body_sleep_investigationInvestigate Withings body measures and adjacent sleep context.

Resources

Contextual data attached and managed by the client

NameDescription
withings_data_inventoryStatic inventory of supported Withings data domains, privacy modes and recommended first calls.
withings_capabilitiesStatic capabilities, API boundary, privacy modes and recommended agent workflow.
withings_agent_manifestMachine-readable install and operating instructions for AI agents.
withings_latest_activityMost recent Withings activity record in the configured privacy mode.
withings_latest_sleepMost recent Withings sleep summary in the configured privacy mode.
withings_daily_summaryDaily Withings health summary built from API data.
withings_weekly_summaryWeekly Withings health review built from API data.

Latest Blog Posts

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