akutishevsky/withings-mcp

[Help me pay for the servers on Patreon][patreon]
[patreon]: https://patreon.com/akutishevskyi?utm_medium=unknown&utm_source=join_link&utm_campaign=creatorshare_creator&utm_content=copyLink
A Model Context Protocol (MCP) server that brings your Withings health data into Claude. Access your sleep patterns, body measurements, workouts, heart data, and more through natural conversation.
**🔒 Privacy First**: This is my personal project, and the repository is intentionally public to demonstrate transparency. The code shows that **no personal information is logged or stored maliciously**. All sensitive data (tokens, user IDs) is encrypted at rest and automatically redacted from logs. You can review the entire codebase to verify this commitment to privacy.
**⚠️ Disclaimer**: This server is provided **as-is** without any guarantees or warranties. While I've made every effort to ensure security and privacy, I make no guarantees about availability, data integrity, or security. Use at your own risk. For production use cases, consider self-hosting your own instance.
Quick Setup
1. Open **Claude Desktop** → **Customize** → **Connectors**
2. Click **+** → **Add Custom Connector**
3. Set URL to https://withings-mcp.com/mcp → click **Add**
4. Click **Connect** and authorize with your Withings account
That's it! Ask Claude about your sleep, weight, workouts, or heart data.
Demo
Table of Contents
- Quick Setup
- Demo
- 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
- OAuth Hardening
- Transport Security
- Privacy-Safe Logging
- Contributing
- License
- Support
- Acknowledgments
What 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 computer
Setup Instructions
Step 1: Add Connector in Claude Desktop
1. Open Claude Desktop
2. Go to **Customize** (in the sidebar or menu)
3. Navigate to the **Connectors** section
4. Click the **+** button to add a new connector
5. Select **Add Custom Connector**
6. Fill in the following details:
- **Name**: Withings (or any name you prefer)
- **Remote MCP server URL**: https://withings-mcp.com/mcp
7. 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