# Oura MCP for AI Agents AI Agent Connect > Oura MCP for AI Agents. This connector gives you direct access to your Oura Ring health metrics, including sleep scores, activity levels, readiness, HRV, and heart rate. Instead of jumping through menus in the Oura app, you can ask your agent for a summary of your recovery or training stats in seconds. It turns your wearable data into a conversational health dashboard. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_svxDJKGG804lvGTAEC0foQcbhTCnpIbawWkxNGPv/ai-agent-connect - **Tags:** wearable-tech, sleep-tracking, health-metrics, hrv, activity-monitoring ## Description This Connector lets you talk to your Oura Ring data instead of digging through nested menus and charts. You can ask your agent about your sleep stages, check your readiness score for the day, or see how your workouts are impacting your recovery. It's about getting a clear picture of your health without the manual effort of switching apps. You can even look at your manual mood tags to see if they correlate with your HRV or sleep quality. Vinkius makes it easy to plug this into your workflow so you can get answers in seconds. You'll stop copy-pasting numbers and start getting actual insights from your wearable data. Whether you're trying to figure out why you're feeling tired or want to see if your training block is actually working, you can just ask. It pulls your heart rate samples, activity goals, and sleep efficiency into one place. You get to stay in your current workspace while your agent handles the data fetching. It's a much faster way to keep track of your body's signals. You can look at your activity goals to see if you're hitting your daily step targets or check your heart rate zones during a run. This turns your wearable into a conversational database where you can ask questions about your physical state and get straight answers. ## Tools ### get_sessions Get overall scores, sleep metrics, and readiness for specific dates. This helps you see a high-level summary of your health trends at a glance. ### get_sleep Fetch detailed sleep stages and efficiency for a date range. You can see exactly how much time you spent in deep or REM sleep. ### get_tags Retrieve your manual mood, energy, and behavior entries. This lets you see how your habits correlate with your physical metrics. ### get_workouts List all logged workouts including type and duration. Use this to review your training history and see your total volume. ### get_activity Pull daily steps, calories, and activity goals. You can quickly check if you met your movement targets for the day. ### get_heart_rate Access high-frequency heart rate and HRV samples. This is useful for looking at specific heart rate spikes during intense activity. ### get_readiness Get your current readiness score and recovery status. See if your body is recovered enough for a heavy training session. ## Prompt Examples **Prompt:** ``` How did I sleep last night? ``` **Response:** ``` ### Sleep Summary * **Sleep Score:** 85/100 * **Total Sleep:** 7h 42m * **Sleep Efficiency:** 92% | Stage | Duration | | :--- | :--- | | **Deep** | 2h 10m | | **REM** | 1h 45m | | **Light** | 3h 15m | | **Awake** | 32m | **Notes:** Your sleep onset was 15 minutes, and restlessness was low. ``` **Prompt:** ``` What is my readiness score today? ``` **Response:** ``` ### Today's Readiness Your score is **82/100 (Good)**. * **HRV:** 65ms * **Resting HR:** 51 bpm * **Body Temp:** 36.6°C * **Sleep Balance:** 8h 5m * **Activity Balance:** Well recovered **Previous Day Strain:** 14 ``` **Prompt:** ``` Show me my activity from yesterday. ``` **Response:** ``` ### Yesterday's Activity * **Activity Score:** 75/100 * **Steps:** 8,450 * **Calories:** 2,340 (520 active) * **MET Minutes:** 145 * **Average HR:** 72 bpm * **Daily Goal:** 85% achieved ``` ## Capabilities ### Pull sleep stages Get specific data on your REM, deep, and light sleep cycles. ### Check activity goals See if you hit your daily step and calorie targets. ### Get readiness scores Instantly view your recovery status and HRV metrics. ### Review mood tags Access your manual entries for energy, mood, and behaviors. ### Browse workout history List all logged workouts with types and durations. ### Fetch heart rate samples Retrieve high-frequency heart rate and HRV data points. ## Use Cases ### Checking workout readiness An athlete asks their agent if they should hit a PR today. The agent uses `get_readiness` and `get_sleep` to check recovery and suggests a rest day. ### Correlating habits and sleep A biohacker wants to know if caffeine affects their sleep. The agent pulls `get_tags` and `get_sleep` to find patterns in their data. ### Weekly activity summary A user wants to see their progress. The agent uses `get_activity` to summarize total steps and calories for the past seven days. ### Detailed sleep analysis Someone wakes up tired and asks why. The agent pulls `get_sleep` to show the breakdown of REM, deep, and light sleep stages. ## Benefits - No more app switching. Use `get_sessions` to see a summary of your sleep and readiness without leaving your chat. - Better recovery tracking. Use `get_readiness` to see if you're actually ready for a heavy lift or a long run today. - Correlation of habits. Use `get_tags` to see if your mood or energy levels actually impact your sleep quality. - Workout analysis. Use `get_workouts` to review your training load and heart rate zones over time. - Deep sleep insights. Use `get_sleep` to see exactly how much REM and deep sleep you're getting each night. - Precise heart data. Use `get_heart_rate` to check high-frequency samples for specific time windows. ## How It Works The bottom line is you get a conversational interface for your wearable health data. 1. Subscribe to the Oura MCP on Vinkius. 2. Add your Oura Personal Access Token to the settings. 3. Ask your agent questions about your sleep, activity, or recovery. ## Frequently Asked Questions **Can I use the Oura MCP with Claude?** Yes, you can connect this Connector to Claude or any other MCP-compatible client to talk to your Oura data. **How do I connect my Oura Ring to my agent?** You just need to subscribe to the Connector on Vinkius and provide your Oura Personal Access Token in the settings. **Can I see my sleep stages with this?** Yes, the Connector can pull your specific sleep stages, including REM, deep, and light sleep, for any date range you choose. **Does the Oura MCP show my heart rate?** It can retrieve high-frequency heart rate samples and HRV data, which is great for analyzing your heart's response to activity. **Can I check my workout history?** Yes, you can ask your agent to list all your logged workouts, including the type of exercise, duration, and calories burned. **Is my Oura data private?** Your data remains private. The Connector simply acts as a bridge to fetch the information you request from your Oura account. **How do I get an Oura Personal Access Token?** Log in to your Oura account at [**cloud.ouraring.com**](https://cloud.ouraring.com/oauth2/authorize), create a personal access token in your account settings. The token gives access to your sleep, activity, readiness and health data. **What health data is available?** Sleep (score, stages, efficiency), Activity (steps, calories, MET), Readiness (score, HRV, RHR, temperature), Tags (mood, energy, behaviors), Workouts (type, duration, HR zones) and Heart Rate (5-min samples). **How far back can I access data?** You can access all historical data recorded by your Oura Ring. Use start_date and end_date parameters to filter results. Data is paginated with a nextToken for large date ranges.