# RescueTime MCP for AI Agents AI Agent Connect > RescueTime MCP lets you query your productivity data, start focus sessions, and manage your time logs through your AI agent. It connects your RescueTime account to any MCP-compatible client so you can see where your time actually goes and control your deep work blocks without leaving your workspace. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_hoa95p0K4Q58tLA00V8bFWfwTSvMdlO81HDoNGvf/ai-agent-connect - **Tags:** time-tracking, productivity-metrics, focus-mode, activity-analysis, work-life-balance ## Description Stop jumping between tabs to see if you're actually getting work done. This Connector puts your RescueTime data right where you're already working. Instead of digging through complex dashboards to find your weekly productivity trends, you can just ask your agent for a summary of your most distracting apps or your progress on a specific project. You can also put your focus into high gear by telling your agent to start a session, which triggers the blocks you need to stay in the zone. It handles the tedious stuff like logging offline time or archiving old projects, making it easier to keep your records clean. Because Vinkius makes it so easy to connect these types of tools, you can turn your AI into a personal productivity coach that knows your habits and helps you stick to them. It's about moving from guessing how you spend your day to actually seeing the data and taking action on it immediately. ## Tools ### get_daily_summary_feed Gives you a high-level rollup of your day. This is the fastest way to see what you actually did. ### delete_timeline_activities Removes a range of tracked time. This is perfect for fixing errors in your history. ### end_focus_time Stops the current focus session for premium users. It lets you wrap up your deep work block. ### extend_focus_session Adds more time to your current session. Use this when you're in the zone and don't want to stop. ### get_accounts Shows your account settings. This lets you see how your profile is configured. ### get_alerts Lists all your active alerts. Check these to see if you're hitting your distraction limits. ### get_alerts_feed Shows a log of recently triggered alerts. This helps you see patterns in your distractions. ### get_analytic_data Pulls historical activity and productivity metrics. Use this to see deep trends over weeks or months. ### get_calendar_events Lists your synced calendar events. This helps you see your scheduled commitments alongside your logged time. ### get_categories Lists all your activity categories. Use this to see how your work is being bucketed. ### get_daily_user_summaries Fetches pre-computed daily roll-ups. Use this to get a quick snapshot of your recent history. ### get_devices Lists all machines reporting your time. This helps you see which devices are being used most. ### get_extra_works Lists all your extra-work entries. Use this to review tasks that fall outside your core projects. ### get_focus_sessions Lists your persistent session records. This lets you review your past deep work history. ### get_focustime_ended_feed Shows a feed of finished focus sessions. Use this to see how many sessions you completed today. ### get_focustime_started_feed Shows a feed of sessions that just began. This helps you track your current focus activity. ### get_goals Lists all your current goals. Use this to keep your objectives front and center. ### get_highlights_feed Shows your daily highlights. This lets you see your biggest wins for the day. ### get_managed_users Lists users in your managed teams. Use this to see who is on your team. ### get_overviews Lists your top-level activity buckets. Use this to see the big picture of your time usage. ### get_productivities Lists your productivity score definitions. Use this to see how your scores are calculated. ### get_profile_entities Lists your category and score overrides. Use this to see your custom productivity rules. ### get_projects Lists all your active projects. Use this to see what you're currently working on. ### get_schedules Lists your work schedules. This shows you when you're expected to be active. ### get_timeline_activities Fetches a normalized activity stream for a day. Use this to see a minute-by-minute breakdown of your day. ### get_users Shows your current user info. This lets you verify which account is connected. ### get_web_notification_counts Shows your read and unread counts. Use this to see if you have pending alerts. ### get_web_notifications Lists your in-app notifications. This lets you see specific messages from the RescueTime app. ### log_project_time Logs time against a specific project or task. Use this to track your progress on specific work. ### merge_project_time Combines adjacent time entries. This cleans up your timeline by removing small gaps. ### post_offline_time Logs time spent away from your desk. This helps keep your total day count accurate. ### register_live_activity Registers Apple Live-Activity tokens. This enables real-time updates on your mobile device. ### start_focus_session Starts a global focus session. Use this to enter a state of deep work. ### start_focus_time Triggers a focus session for premium users. This starts your timed deep work block. ### start_focus_zone Starts a focus zone for DND. Use this to block out all distractions during a specific window. ### toggle_timesheet_finalized Locks or unlocks a date's timesheet. Use this to finalize your logs for the day. ### update_user Updates your profile settings. Use this to keep your account information current. ### update_web_notification Marks a notification as read or dismissed. Use this to clear your alert list. ### upsert_profile_entity Updates an override for an app or site. Use this to customize your productivity scores. ### cancel_or_stop_focus_session Ends a focus session immediately. This is useful when you need to break away from a deep work block. ### create_alert Sets up a new notification. Use this to get pinged when you spend too much time on a specific app. ### create_extra_work Adds an entry for work outside your normal scope. This helps keep your productivity data accurate. ### create_goal Sets a new productivity target. Use this to define what you want to achieve in a specific timeframe. ### create_project Starts a new project in RescueTime. This organizes your time into meaningful buckets. ### add_offline_focus_work Logs time spent away from your computer. This ensures your day's total time is fully accounted for. ### archive_project Moves a project to your archives. Use this to clean up your active list when a job is done. ### get_meeting_events Lists events flagged as meetings. This helps you distinguish between deep work and collaboration. ### get_organizations Shows your organization details. Use this to see your company-level settings. ### get_overview_tree Shows a personalized hierarchy with scores. This gives you a structured view of your productivity. ### get_tasks Lists all your tasks. Use this to see the specific items making up your projects. ### get_teams Lists the teams you belong to. This helps you see your organizational context. ### get_user_settings Shows your API-writable settings. Use this to adjust how the tool behaves. ### opt_in_beta Lets you join or leave beta features. Use this to try out the newest RescueTime tools. ### post_highlight Creates a new daily highlight. Use this to manually record a win for the day. ## Prompt Examples **Prompt:** ``` What did I get done today? ``` **Response:** ``` ### Daily Summary Based on your RescueTime logs, here is your productivity for today: | Category | Time Spent | | :--- | :--- | | **Deep Work** | 4h 15m | | **Meetings** | 1h 30m | | **Admin** | 45m | **Key Highlights:** * Completed the API documentation draft. * Finalized the Q3 budget sheet. * Logged 3 focus sessions. ``` **Prompt:** ``` Start a focus session for 60 minutes. ``` **Response:** ``` Focus Session started! I've triggered a 60-minute session via RescueTime. Your distractions are now blocked so you can stay in the zone. Good luck! ``` **Prompt:** ``` Show me my top 3 distractions from yesterday. ``` **Response:** ``` I've analyzed your activity from yesterday. Your top 3 distractions were: 1. **YouTube** (45m) 2. **Twitter** (30m) 3. **Reddit** (15m) Would you like me to set a distraction alert for any of these? ``` ## Capabilities ### Query productivity metrics Get a clear picture of your historical activity and efficiency scores. ### Start and end focus sessions Trigger deep work blocks to block out distractions instantly. ### Get daily activity summaries Receive high-level rollups of your logged time for the day. ### Log offline work and meetings Add time spent away from your desk to keep your records complete. ### Manage projects and goals Create and organize your work buckets and long-term objectives. ### View distraction alerts Check your running log of user-defined alerts and triggers. ## Use Cases ### Breaking the distraction cycle A developer is stuck in a loop of checking Slack. They ask their agent to start a focus session, which triggers a RescueTime block to help them get back into the code. ### Checking project velocity A project manager needs to know how much time was spent on a specific client. They ask the agent to query `get_analytic_data` for that project's category. ### Logging daily wins A freelancer is finishing their day and wants to log a win. They tell the agent to `post_highlight` with a summary of the three tasks they completed. ### Analyzing schedule effectiveness An analyst wants to see if their new schedule is working. They ask the agent to compare `get_schedules` against their `get_timeline_activities` from the last week. ## Benefits - Get instant summaries of your day without leaving your editor by using `get_daily_summary_feed`. - Automatically block distractions with `start_focus_session` to ensure you actually finish your deep work. - Identify time-wasting habits by querying `get_analytic_data` to see which apps are stealing your time. - Keep your logs accurate by using `add_offline_focus_work` to account for meetings and gym time. - Stay organized by using `create_project` and `create_goal` to map out your long-term objectives. - Monitor your team's productivity trends using `get_managed_users` and `get_overviews` without manual spreadsheets. ## How It Works The bottom line is you get a conversational interface for your time-tracking data. 1. Subscribe to this Connector on Vinkius. 2. Enter your RescueTime API Key into your AI client settings. 3. Ask your agent to show your daily summary or start a focus session. ## Frequently Asked Questions **Can I use RescueTime MCP to start focus sessions?** Yes, it triggers the focus sessions you already use in your RescueTime account, allowing you to start them via voice or text. **How does RescueTime MCP help with my productivity?** It gives you a way to query your productivity data easily. You can ask about trends, summaries, and highlights without leaving your workspace. **Does RescueTime MCP work with my existing account?** Yes, it connects directly to your current data. You just need to provide your API key to link your history and settings. **Can I log offline time using RescueTime MCP?** Yes, you can use the Connector to log time spent on meetings, exercise, or other offline activities to keep your daily totals accurate. **How do I see my team's productivity with RescueTime MCP?** If you have a managed team, you can ask the agent to pull summaries and overviews for your managed users to see team-wide trends. **Can I set alerts for specific apps with RescueTime MCP?** Yes, you can create alerts to be notified when you spend too much time on specific websites or apps, helping you stay on track. **What's the best way to use RescueTime MCP for deep work?** The most effective way is to use the focus session tools to block out distractions and the analytic tools to review your progress at the end of the day. **Can I start a Focus Session directly from the chat?** Yes! Use the `start_focus_time` tool and specify the duration in minutes. Your agent will trigger the session to block distracting websites and apps immediately. **How do I see my top productivity categories for yesterday?** You can ask the agent to run `get_analytic_data` with `restrict_kind` set to 'category' and the dates set to yesterday. It will return a ranked list of where your time went. **Is it possible to log achievements or daily wins?** Absolutely. Use the `post_highlight` tool to record a description of what you accomplished. You can later retrieve these using `get_highlights_feed`.