# Withings MCP for AI Agents AI Agent Connect > Withings MCP lets you bring your health data directly into your AI agent. Track weight, blood pressure, sleep scores, steps, and workouts from your Withings scales and watches in one place. It's the fastest way to turn your biometric data into actual insights without jumping between different apps. ## Overview - **Category:** iot-hardware - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_KGZ4al0Lem9IvDnMHcSGL9BRlIDRgrkReq8aSi3A/ai-agent-connect - **Tags:** connected-health, biometric-tracking, sleep-analytics, cardiovascular-health, health-data, wearable-integration ## Description This Withings MCP connects your health data directly to your AI agent so you can stop manual data entry and start making sense of your biometrics. Instead of digging through different apps to see how your sleep affected your workout or how your blood pressure trends over a month, you just ask your agent. It pulls your real-time stats from your Withings scales, watches, and medical devices to give you a clear picture of your wellness. You can check your battery levels, see your latest heart rate readings, and even set up alerts for new measurements. Whether you're trying to hit a specific weight goal or just want to know if your sleep quality is actually improving, this connection makes that data useful. It's one of the best ways to use the Vinkius catalog to bridge the gap between your wearable hardware and your daily planning. You get a personal health analyst that's always online and ready to summarize your day. ## Tools ### get_activity Pull daily summaries for steps and calories. It's great for checking your daily movement. ### get_heart_rate Get specific heart rate measurements. Use this to monitor your pulse during or after exercise. ### get_intraday_activity Access high-frequency data for movement throughout the day. It shows exactly when you're most active. ### get_workouts Get details on running, swimming, and cycling sessions. It provides duration, calories, and distance. ### subscribe_notifications Set up webhooks for instant alerts on new weigh-ins or BP readings. It keeps you updated in real-time. ### get_measurements Fetch weight, height, blood pressure, and body temperature. It's the primary way to get your core physical stats. ### get_sleep_details See your deep, light, and REM sleep stages. This helps you understand your actual rest quality. ### get_sleep_summary Grab a daily overview of your sleep. It's perfect for a quick morning check of your sleep score. ### get_user_devices List all your connected Withings hardware. Use this to check which devices are currently active. ### get_user_goals See your specific health and fitness targets. This keeps your AI agent aware of what you're trying to achieve. ## Prompt Examples **Prompt:** ``` How has my weight changed over the last two weeks? ``` **Response:** ``` Based on your Withings scale data, here is your weight trend: | Date | Weight | Body Fat % | | :--- | :--- | :--- | | Oct 01 | 82.5kg | 19.4% | | Oct 08 | 81.8kg | 19.1% | | Oct 15 | 81.2kg | 18.8% | **Trend:** You've lost **1.3kg** and reduced your body fat by **0.6%** over the last 14 days. Great progress! ``` **Prompt:** ``` Did I get enough sleep last night? ``` **Response:** ``` You slept for **7 hours and 12 minutes** last night. * **Sleep Score:** 88 (Good) * **Stages:** You spent a good amount of time in REM sleep. * **Details:** You fell asleep in 8 minutes but woke up 3 times during the night. Overall, you hit your target sleep duration! ``` **Prompt:** ``` Summarize my workouts from this week. ``` **Response:** ``` Here is what you crushed this week: * **Running:** 3 sessions (Total: 12.4 km) * **Cycling:** 1 session (45 minutes, 450 calories) * **Swimming:** 1 session (30 minutes) You've burned a total of **1,200 calories** across these activities. Keep it up! ``` ## Capabilities ### Pull heart rate trends Get specific heart rate measurements from your devices to monitor your pulse during or after exercise. ### Track sleep stages See your deep, light, and REM sleep stages to understand your actual rest quality. ### Monitor weight and body fat Fetch weight, height, and body fat percentages to keep your core physical stats organized. ### See daily step counts Grab daily summaries for steps and calories to check your movement goals. ### Log workout durations Get details on running, swimming, and cycling sessions, including calories and distance. ### Set up real-time alerts Configure webhooks for instant notifications on new weigh-ins or blood pressure readings. ## Use Cases ### Optimizing Recovery A runner asks their agent to compare sleep scores from get_sleep_summary with their workout intensity from get_workouts to see if they need a rest day. ### Weight Loss Tracking A user wants to see their body fat percentage trend over three months. The agent uses get_measurements to build a summary table of their progress. ### Daily Activity Check A busy professional asks, "Did I hit my step goal today?" The agent checks get_activity and gives a quick yes or no. ### Health Monitoring A person with high blood pressure asks for their average systolic reading from the last week. The agent pulls this from get_measurements. ## Benefits - Get instant sleep analysis by comparing get_sleep_details with your daily goals to see if your recovery is actually improving. - Monitor your blood pressure and weight trends over time using get_measurements to keep your health stats organized in one place. - Stay on top of your fitness by pulling workout history from get_workouts to see exactly how much progress you've made this week. - Automate your health tracking with subscribe_notifications so you don't have to manually check your scale every morning. - Understand your daily movement better by using get_intraday_activity to identify patterns in your active hours. - Keep your hardware running smoothly by checking your device battery and connection status with get_user_devices. ## How It Works The bottom line is you get a direct data pipeline from your Withings hardware to your AI agent. 1. Subscribe to the Withings MCP on the marketplace. 2. Register an app in the Withings Developer Portal to get your OAuth Access Token. 3. Connect the token to your AI client to start querying your health data. ## Frequently Asked Questions **Can the Withings MCP track my blood pressure?** Yes, it pulls systolic and diastolic readings directly from your connected Withings blood pressure monitors. **Does the Withings MCP work with my smart scale?** It connects to your Withings scales to pull weight and body fat data into your AI agent automatically. **How do I get my sleep scores into my AI agent?** By connecting this Connector, your agent can see your sleep stages and daily summaries directly from your Withings watch. **Can I use the Withings MCP to see my heart rate?** Yes, it can pull specific heart rate measurements from your connected Withings hardware for easy viewing. **Does the Withings MCP support workout tracking?** It pulls data for running, swimming, and cycling, including duration, calories, and distance. **Is the Withings MCP good for tracking weight loss?** It's perfect for that because it can pull your body fat and weight trends over time to show your progress. **How do I filter for specific measurements like Body Fat or Blood Pressure?** Use the `meastype` parameter with the `get_measurements` tool. Common types: 1 (Weight), 4 (Height), 8 (Fat Mass), 9 (Diastolic BP), 10 (Systolic BP), 11 (Heart Pulse), 71 (Body Temperature). **What is the difference between sleep summary and sleep details?** `get_sleep_summary` returns one overall score and total duration per night. `get_sleep_details` returns high-frequency intraday data, detailing exactly what time you entered REM, deep sleep, or woke up throughout the night. **Can I receive real-time notifications when I step on the scale?** Yes, use the `subscribe_notifications` tool with an `appli` ID of 1 (Weight). Withings will then send a POST webhook to the callback URL you specify the moment a new weight measurement is synced.