Privacy-first, unofficial Withings MCP server for AI health, sleep, activity and heart-rate agents.
Connect Runs on your machine
claude mcp add withingsmcp -e WITHINGS_CLIENT_ID=<WITHINGS_CLIENT_ID> -e WITHINGS_CLIENT_SECRET=<WITHINGS_CLIENT_SECRET> -e WITHINGS_REDIRECT_URI=<WITHINGS_REDIRECT_URI> -e WITHINGS_TOKEN_PATH=<WITHINGS_TOKEN_PATH> -e WITHINGS_PRIVACY_MODE=<WITHINGS_PRIVACY_MODE> -e WITHINGS_CACHE=<WITHINGS_CACHE> -e WITHINGS_CACHE_PATH=<WITHINGS_CACHE_PATH> -e WITHINGS_NO_CACHE=<WITHINGS_NO_CACHE> -- npx -y [email protected]
{
"mcpServers": {
"withingsmcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"WITHINGS_CLIENT_ID": "<WITHINGS_CLIENT_ID>",
"WITHINGS_CLIENT_SECRET": "<WITHINGS_CLIENT_SECRET>",
"WITHINGS_REDIRECT_URI": "<WITHINGS_REDIRECT_URI>",
"WITHINGS_TOKEN_PATH": "<WITHINGS_TOKEN_PATH>",
"WITHINGS_PRIVACY_MODE": "<WITHINGS_PRIVACY_MODE>",
"WITHINGS_CACHE": "<WITHINGS_CACHE>",
"WITHINGS_CACHE_PATH": "<WITHINGS_CACHE_PATH>",
"WITHINGS_NO_CACHE": "<WITHINGS_NO_CACHE>"
}
}
}
}
{
"mcpServers": {
"withingsmcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"WITHINGS_CLIENT_ID": "<WITHINGS_CLIENT_ID>",
"WITHINGS_CLIENT_SECRET": "<WITHINGS_CLIENT_SECRET>",
"WITHINGS_REDIRECT_URI": "<WITHINGS_REDIRECT_URI>",
"WITHINGS_TOKEN_PATH": "<WITHINGS_TOKEN_PATH>",
"WITHINGS_PRIVACY_MODE": "<WITHINGS_PRIVACY_MODE>",
"WITHINGS_CACHE": "<WITHINGS_CACHE>",
"WITHINGS_CACHE_PATH": "<WITHINGS_CACHE_PATH>",
"WITHINGS_NO_CACHE": "<WITHINGS_NO_CACHE>"
}
}
}
}
{
"servers": {
"withingsmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"WITHINGS_CLIENT_ID": "<WITHINGS_CLIENT_ID>",
"WITHINGS_CLIENT_SECRET": "<WITHINGS_CLIENT_SECRET>",
"WITHINGS_REDIRECT_URI": "<WITHINGS_REDIRECT_URI>",
"WITHINGS_TOKEN_PATH": "<WITHINGS_TOKEN_PATH>",
"WITHINGS_PRIVACY_MODE": "<WITHINGS_PRIVACY_MODE>",
"WITHINGS_CACHE": "<WITHINGS_CACHE>",
"WITHINGS_CACHE_PATH": "<WITHINGS_CACHE_PATH>",
"WITHINGS_NO_CACHE": "<WITHINGS_NO_CACHE>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
WITHINGS_CLIENT_IDOptional | Withings OAuth client ID. Optional when configured with withings-mcp-server setup. |
WITHINGS_CLIENT_SECRETOptional, secret | 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_URIOptional | Redirect URI configured in the Withings Developer Dashboard. Optional when configured with withings-mcp-server setup. |
WITHINGS_TOKEN_PATHOptional | Optional local path for OAuth tokens. Defaults to ~/.withings-mcp/tokens.json. |
WITHINGS_PRIVACY_MODEOptional | Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full Withings API payloads, not continuous 24/7 raw sensor telemetry. |
WITHINGS_CACHEOptional | Optional SQLite cache toggle. Set to true or sqlite to enable. |
WITHINGS_CACHE_PATHOptional | Optional local SQLite cache path. Defaults to ~/.withings-mcp/cache.sqlite. |
WITHINGS_NO_CACHEOptional | 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. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 3 Jul 2026 |
| Last updated | 3 Jul 2026 |
| Registry name | io.github.davidmosiah/withingsmcp |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
