Withings
About
A Model Context Protocol (MCP) server that brings your Withings health data into MCP client. Access your sleep patterns, body measurements, workouts, heart data, and more through natural conversation.
Details
- Transport
- SSE
Explore
- Access sleep, activity, body measurements, workouts, and heart data
- Tools for sleep summary, activity, intraday activity, workouts, measures, devices, goals, heart records, and stethoscope data
- AES-256-GCM encryption of all tokens at rest
- Privacy‑safe logging that automatically redacts sensitive information
- OAuth 2.0 authentication with Withings
- Self‑hosting option for developers (Node.js 18+ and Deno CLI required)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
WithingsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. A Withings account with connected devices
2. Claude Desktop or any other MCP-compatible client installed on your computer
npm install
cp .env.example .env
``bash
| Variable | Required | Description |
|----------|----------|-------------|
| WITHINGS_CLIENT_ID | Yes | Your Withings app client ID |WITHINGS_CLIENT_SECRET
| | Yes | Your Withings app client secret |WITHINGS_REDIRECT_URI
| | Yes | OAuth callback URL (must match Withings app settings) |ENCRYPTION_SECRET
| | Yes | 32+ character secret for token encryption (generate with npm run generate-secret) |PORT
| | No | Server port (default: 3000) |LOG_LEVEL
| | No | Logging level: trace, debug, info, warn, error (default: info) |ALLOWED_ORIGINS` | No | Comma-separated list of allowed CORS origins for browser clients |
|
Once connected, Claude can use these tools to access your data:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"withings": {
"withings": {
"url": "https://withings-mcp.com/mcp",
"oauth": {
"type": "oauth2",
"authorizationUrl": "https://withings-mcp.com/authorize",
"tokenUrl": "https://withings-mcp.com/token",
"scope": "user.metrics user.activity"
}
}
}
}
}McpServers
{
"withings": {
"url": "https://withings-mcp.com/mcp",
"oauth": {
"type": "oauth2",
"authorizationUrl": "https://withings-mcp.com/authorize",
"tokenUrl": "https://withings-mcp.com/token",
"scope": "user.metrics user.activity"
}
}
}Table of Contents
- What Can You Do With This? - For End Users: Using the Hosted Server - Prerequisites - Setup Instructions - Available Tools - Example Conversations - Privacy & Security - For Developers: Self-Hosting - Prerequisites - Step 1: Create Withings Application - Step 2: Clone and Setup - Step 3: Local Development - Step 4: Deploy to Production - Step 5: Update Withings App Settings - Step 6: Configure Your MCP Client - Environment Variables Reference - Development Commands - Project Structure - Security Features - Token Encryption - Privacy-Safe Logging - Contributing - License - Support - AcknowledgmentsWhat Can You Do With This?
This MCP server gives Claude access to your Withings health data, allowing you to: - Analyze your sleep: Ask about sleep quality, duration, deep sleep stages, heart rate during sleep - Track body metrics: Weight trends, body composition, blood pressure, heart rate over time - Review workouts: Analyze exercise patterns, calories burned, heart rate zones - Monitor heart health: Access ECG recordings and detailed heart data - Set and track goals: Review your fitness and health goals - Identify patterns: Find correlations between sleep, activity, and other metrics - Generate insights: Get AI-powered analysis of your health trends All through natural conversation with Claude or any other MCP-compatible client.For End Users: Using the Hosted Server
If you just want to use this MCP server with Claude Desktop without hosting anything yourself, follow these steps:Prerequisites
1. A Withings account with connected devices 2. Claude Desktop or any other MCP-compatible client installed on your computerSetup Instructions
Step 1: Add Connector in Claude Desktop
1. Open Claude Desktop 2. Go to Settings (gear icon in the bottom-left corner) 3. Navigate to the Connectors tab 4. Click Add Custom Connector 5. Fill in the following details: - Name:Withings (or any name you prefer)
- Remote MCP server URL: https://withings-mcp.com/mcp
6. Click Add
> Note: If your MCP client doesn't support UI-based connector configuration, you can manually edit the config file instead. See the manual configuration guide below.
Step 2: Connect and Authorize
1. In the Connectors settings, find the Withings connector you just added 2. Click Connect next to the connector 3. Your web browser will open with the Withings authorization page 4. Log in to your Withings account 5. Review and approve the permissions requested 6. You'll be redirected back and the connection will be complete After authorization, Claude will have access to your Withings data!Available Tools
Once connected, Claude can use these tools to access your data:Sleep & Activity
-get_sleep_summary - Sleep duration, stages (light/deep/REM), heart rate, breathing, sleep score
- get_activity - Daily steps, distance, calories, elevation, activity durations
- get_intraday_activity - High-frequency activity data throughout the day
- get_workouts - Detailed workout summaries with heart rate zones and metrics
Body Measurements
-get_measures - Weight, body composition, blood pressure, heart rate, temperature, VO2 max, and more
Devices & Goals
-get_user_devices - List of connected Withings devices
- get_user_goals - Your health and fitness goals (steps, sleep, weight)
Heart Health
-list_heart_records - List of ECG recordings
- get_heart_signal - Detailed ECG waveform data
Stethoscope (if you have BPM Core)
-list_stetho_records - List of stethoscope recordings
- get_stetho_signal - Detailed audio signal data
Example Conversations
Try asking Claude: - "How has my sleep quality been over the past week?" - "Show me my weight trend for the last month" - "What's my average resting heart rate?" - "Did I hit my step goal this week?" - "Compare my workout intensity between this month and last month" - "When did I sleep best this month?"Privacy & Security
- Encrypted tokens: All authentication tokens are encrypted using AES-256-GCM before storage - No logging of personal data: The code is public - you can verify that no sensitive information is logged - Automatic redaction: All user IDs, tokens, and credentials are automatically redacted from system logs - OAuth 2.0: Industry-standard secure authentication with Withings - You're in control: Revoke access anytime from your Withings account settings ---For Developers: Self-Hosting
Want to run your own instance? Here's how to deploy this MCP server yourself.Prerequisites
1. Node.js 18+ and npm installed 2. Deno CLI installed for deployment 3. A Withings Developer AccountStep 1: Create Withings Application
1. Go to Withings Developer Portal 2. Create a new application 3. Note your Client ID and Client Secret 4. Set your Redirect URI to:https://your-domain.com/callback
- This must be a publicly accessible URL (localhost is not supported by Withings)
- Can be any domain where you'll host the server (e.g., Deno Deploy, your own server, etc.)
Step 2: Clone and Setup
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
