Withings MCP Server

# Release Notes v1.0.0 **Release Date:** 2024-12-20 ## 🎉 Initial Release First stable release of the Withings MCP Server for Claude Desktop! ## ✨ Features ### OAuth2 Authentication - Automatic token generation with local callback server - Automatic token refresh when expired - Secure credential management via environment variables ### Health Data Access #### Body Measurements - Weight (kg) - Height (m) - Body fat percentage (%) - Fat-free mass (kg) - Fat mass (kg) - Muscle mass (kg) - Bone mass (kg) - Diastolic and systolic blood pressure (mmHg) - Heart rate (bpm) - Temperature (°C) - SpO2 (%) - Pulse wave velocity (m/s) #### Activity Data - Daily steps - Calories burned - Distance covered - Elevation gain #### Sleep Data - Sleep duration - Deep sleep phases - REM sleep phases - Wake-up counts - Detailed sleep phase tracking #### Workout Data - Training sessions - Workout metrics - Exercise details #### Heart Rate - Intraday heart rate measurements - Continuous monitoring data ## 🛠️ Available Tools - `get_user_info` - Get user account information and connected devices - `get_measurements` - Retrieve body measurements with flexible filtering - `get_activity` - Get daily activity data - `get_sleep_summary` - Get sleep summaries - `get_sleep_details` - Get detailed sleep phase data - `get_workouts` - Retrieve workout sessions - `get_heart_rate` - Get heart rate measurements over time - `get_authorization_url` - Generate OAuth URLs for authentication ## 📦 Installation ```bash # Clone the repository git clone https://github.com/schimmmi/withings-mcp-server.git cd withings-mcp-server # Create virtual environment python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies pip install -e . # Generate tokens python generate_tokens.py ``` ## 🔧 Configuration Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`): ```json { "mcpServers": { "withings": { "command": "/path/to/.venv/bin/python", "args": ["-m", "withings_mcp_server"], "env": { "WITHINGS_CLIENT_ID": "your_client_id", "WITHINGS_CLIENT_SECRET": "your_client_secret", "WITHINGS_ACCESS_TOKEN": "your_access_token", "WITHINGS_REFRESH_TOKEN": "your_refresh_token" } } } } ``` ## 📋 Requirements - Python 3.10+ - Withings Developer Account - Claude Desktop (for MCP integration) ## 🚀 What's Next Future releases will include: - Additional health metrics - Improved error handling - Rate limit management - More detailed data filtering options - Webhook support for real-time updates ## 🐛 Known Issues None at this time. ## 📚 Documentation - [README](../README.md) - [API Documentation](https://developer.withings.com/api-reference/) ## 🔗 Links - [GitHub Repository](https://github.com/schimmmi/withings-mcp-server) - [Release Page](https://github.com/schimmmi/withings-mcp-server/releases/tag/v1.0.0) - [Withings Developer Portal](https://developer.withings.com/)