MCP Connector

Connect Withings Health Data to Claude

An MCP server that brings your Withings sleep, body measurement, workout, and heart rate data into Claude.

Works with withings

74
Spark score
out of 100
Updated 8 days ago
Version 1.0.0
Models

Add to Favorites

Why it matters

Integrate your Withings health and fitness data into Claude for natural language querying and analysis. Access sleep, activity, body measurements, and more through conversational AI.

Outcomes

What it gets done

01

Query sleep patterns, activity levels, and body composition.

02

Analyze workout data and heart health metrics.

03

Track progress towards health and fitness goals.

04

Generate AI-powered health trend reports.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-withings | bash

Capabilities

Tools your agent gets

get_sleep_summary

Retrieve sleep duration, phases (light/deep/REM), heart rate, breathing, and sleep score

get_activity

Get daily steps, distance, calories, elevation, and activity duration

get_intraday_activity

Retrieve high-frequency activity data throughout the day

get_workouts

Get detailed workout information with heart rate zones and metrics

get_measures

Retrieve weight, body composition, blood pressure, heart rate, temperature, VO2 max

get_user_devices

List all connected Withings devices

get_user_goals

Get your health and fitness goals for steps, sleep, and weight

list_heart_records

List of ECG records

+3 tools

Overview

Withings MCP Server

An MCP server that connects your Withings account to Claude, giving conversational access to sleep, activity, workout, heart rate, and body composition data with AI-driven trend analysis. Use it to query your own Withings health data conversationally - it requires a connected Withings account and either self-hosting with an OAuth callback URL or the provided hosted server.

What it does

This MCP server integrates your Withings data into Claude, giving natural-conversation access to sleep, body measurements, workouts, heart rate data, and more.

When to use - and when NOT to

Use it to query your own Withings health data conversationally - sleep quality over the past week, a weight trend over the last month, your average resting heart rate, whether you hit your weekly step goal, or comparing workout intensity between two months. It requires a Withings account with connected devices, and self-hosting requires a publicly accessible URL for OAuth callbacks - a hosted server is available at withings-mcp.com/mcp for anyone who doesn't want to deploy their own.

Capabilities

It exposes eleven tools: get_sleep_summary (sleep duration, phases - light/deep/REM, heart rate, breathing, sleep score), get_activity (daily steps, distance, calories, elevation, activity duration), get_intraday_activity (high-frequency activity data throughout the day), get_workouts (detailed workout data with heart rate zones and metrics), get_measures (weight, body composition, blood pressure, heart rate, temperature, VO2 max, and more), get_user_devices (connected Withings devices), get_user_goals (your health and fitness goals - steps, sleep, weight), list_heart_records and get_heart_signal (ECG record list and detailed ECG curve data), and list_stetho_records and get_stetho_signal (stethoscope record list and detailed sound signal data).

Beyond raw data access it analyzes sleep quality, duration, deep-sleep phases, and heart rate during sleep; tracks body metric trends including weight, body composition, and blood pressure; reviews workout and exercise patterns, calories burned, and heart rate zones; monitors heart health via ECG records; sets and tracks fitness and health goals; identifies patterns and correlations across sleep, activity, and other metrics; and generates AI-driven health trend analysis. It's built privacy-first - encrypted tokens, no logging of personal data, and secure OAuth 2.0 authentication with Withings.

How to install

To self-host from source:

git clone https://github.com/your-username/withings-mcp.git
cd withings-mcp
npm install
npm run generate-secret
cp .env.example .env
npm run build
npm start

Required environment variables: WITHINGS_CLIENT_ID and WITHINGS_CLIENT_SECRET (your Withings app credentials), WITHINGS_REDIRECT_URI (OAuth callback URL matching your Withings app settings), and ENCRYPTION_SECRET (32+ characters, generated via npm run generate-secret). Optional variables include PORT (default 3000), LOG_LEVEL (trace/debug/info/warn/error, default info), and ALLOWED_ORIGINS for browser-client CORS. All sensitive data is encrypted at rest with AES-256-GCM and stripped from logs automatically. Alternatively, use the hosted server by adding a custom connector in Claude Desktop's Settings pointed at the remote MCP URL, with no self-hosting required.

Who it's for

Withings device owners who want to query their own sleep, activity, heart health, and body composition data conversationally instead of digging through the Withings app.

Source README

An MCP server that integrates your Withings data into Claude, providing access to sleep information, body measurements, workouts, heart rate data, and much more through natural conversation.

Installation

Hosted Server

1. Open Claude Desktop
2. Go to Settings → Connectors tab
3. Click Add Custom Connector
4. Remote MCP server URL: https://withings-mcp.com/mcp

From Source

git clone https://github.com/your-username/withings-mcp.git
cd withings-mcp
npm install
npm run generate-secret
cp .env.example .env
npm run build
npm start

Available Tools

Tool Description
get_sleep_summary Sleep duration, phases (light/deep/REM), heart rate, breathing, sleep score
get_activity Daily steps, distance, calories, elevation, activity duration
get_intraday_activity High-frequency activity data throughout the day
get_workouts Detailed workout information with heart rate zones and metrics
get_measures Weight, body composition, blood pressure, heart rate, temperature, VO2 max, and more
get_user_devices List of connected Withings devices
get_user_goals Your health and fitness goals (steps, sleep, weight)
list_heart_records List of ECG recordings
get_heart_signal Detailed ECG waveform data
list_stetho_records List of stethoscope recordings
get_stetho_signal Detailed audio signal data

Features

  • Analyze sleep quality, duration, deep sleep phases, and heart rate during sleep
  • Track body metrics including weight trends, body composition, and blood pressure
  • Review workouts and analyze exercise patterns, calories burned, and heart rate zones
  • Monitor heart health with access to ECG recordings and detailed cardiac data
  • Set and track fitness and health goals
  • Identify patterns and find correlations between sleep, activity, and other metrics
  • Generate AI-powered analysis of health trends
  • Privacy-first with encrypted tokens and no personal data logging
  • Secure OAuth 2.0 authentication with Withings

Environment Variables

Required

  • WITHINGS_CLIENT_ID - Your Withings application client ID
  • WITHINGS_CLIENT_SECRET - Your Withings application client secret
  • WITHINGS_REDIRECT_URI - OAuth callback URL (must match your Withings app settings)
  • ENCRYPTION_SECRET - 32+ character secret for token encryption (generate with npm run generate-secret)

Optional

  • PORT - Server port (default: 3000)
  • LOG_LEVEL - Logging level: trace, debug, info, warn, error (default: info)
  • ALLOWED_ORIGINS - Comma-separated list of allowed CORS origins for browser clients

Usage Examples

How was my sleep quality over the last 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 the intensity of my workouts between this month and last month

Resources

Notes

This server requires a Withings account with connected devices and a publicly accessible URL for OAuth callbacks. A hosted server is available at withings-mcp.com/mcp for users who don't want to deploy their own. All sensitive data is encrypted at rest using AES-256-GCM and automatically scrubbed from logs.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.