Withings MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
About The Project
A self-hosted MCP server that gives Claude access to your Withings health data. Uses MCP OAuth 2.0 with third-party delegation — when Claude connects, you're redirected to Withings to authorize. No manual token management needed.
11 read-only tools covering body measurements, activity, sleep, heart rate/ECG, and device information from Withings scales, watches, blood pressure monitors, thermometers, and sleep trackers.
Related MCP server: Withings MCP Server
Built With
Getting Started
Prerequisites
Docker and Docker Compose
A Withings developer account with a registered app
A Cloudflare Tunnel token
Withings App Setup
Go to developer.withings.com and log in to the Partner Hub
Create a new application
Set Redirect URL to
https://<your-tunnel-url>/withings-callbackNote your Client ID and Client Secret
Installation
Clone the repo
git clone https://github.com/npab19/withings-mcp.git cd withings-mcpCopy the environment template
cp .env.example .envFill in your credentials in
.env:WITHINGS_CLIENT_ID=your_client_id WITHINGS_CLIENT_SECRET=your_client_secret SERVER_URL=https://your-tunnel-url.example.com Cloudflare_Token=your_cloudflare_tunnel_tokenStart the services
docker compose up -d
Usage
Claude.ai Web Connectors
Set the connector URL to:
https://<your-tunnel-url>/mcpOAuth authentication will be handled automatically when you first connect.
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"withings": {
"type": "http",
"url": "https://<your-tunnel-url>/mcp"
}
}
}Available Tools
Category | Tools | Description |
Body Measurements | 1 | Weight, fat mass, muscle mass, bone mass, blood pressure, temperature, SpO2, hydration, and more |
Activity | 1 | Daily steps, distance, calories, elevation, heart rate zones |
Intraday Activity | 1 | Minute-level heart rate, steps, SpO2, HRV, calories, elevation |
Workouts | 1 | Exercise sessions with duration, calories, HR zones, swimming metrics |
Sleep | 1 | Minute-level sleep states, heart rate, respiration rate, snoring |
Sleep Summary | 1 | Nightly aggregates: sleep score, duration, phases, breathing disturbances |
Heart Recordings | 1 | ECG recording list with AFib classification |
Heart Signal | 1 | Raw ECG waveform data in microvolts |
Devices | 1 | Device type, model, battery, firmware, last sync |
Goals | 1 | Steps, sleep, and weight targets |
Roadmap
Core Withings API read endpoints
MCP OAuth 2.0 with Withings delegation
Docker + Cloudflare Tunnel deployment
Token persistence across restarts
Subscription/webhook support for real-time data
Write endpoints (log measurements, set goals)
Contributing
Fork the Project
Create your Feature Branch (
git checkout -b feature/AmazingFeature)Commit your Changes (
git commit -m 'Add some AmazingFeature')Push to the Branch (
git push origin feature/AmazingFeature)Open a Pull Request
License
Distributed under the MIT License. See LICENSE for more information.
Acknowledgments
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Withings health data — sleep, activity, heart, and body metrics.
Pace is a remote MCP server that exposes wearable and fitness data to Claude via the Model Context Protocol. It connects to Garmin, Oura, Whoop, Polar, Fitbit and 20+ devices and provides 15 tools for querying sleep, activity, recovery, and training data. Hosted on Google Cloud Run, OAuth 2.1 authentication, Streamable HTTP transport. Instructions: First you need to create an account at: https://pacetraining.co and connect your wearables. After that you can connect the remote Server via Custom Connector in Claude and OAuth 2.1 Flow startet.
Multi-tenant hosted MCP server for Oura Ring — 21 read-only tools, OAuth per user.
Hosted MCP server with managed OAuth for 15+ toolkits: Google Workspace, Fitbit, Oura, Kalshi, etc.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects Whoop health data to Claude via an MCP server, enabling retrieval of recovery, sleep, strain, and workout metrics through natural language tools.MIT
- AlicenseNot gradedqualityBmaintenanceA 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.46MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives Claude access to your Garmin Connect fitness and health data, including steps, sleep, activities, heart rate, and more.1MIT
- AlicenseAqualityCmaintenanceMCP server for the Withings Health API with per-user OAuth2, enabling users to securely access their own health data (measures, activity, sleep, workouts, heart rate, devices, and goals) and optionally add measurements.12Apache 2.0