RescueTime MCP for AI. Analyze exactly where your time goes, instantly.
Works with every AI agent you already use
…and any MCP-compatible client








How this MCP server connects to your AI agent
RescueTime connects deep productivity metrics and focus management directly to your AI agent. It lets you query historical time usage, track specific projects, start immediate focus blocks, and get daily summaries—all without leaving your chat interface.
Stop manually crunching CSVs; just ask the agent for a performance report.
What AI agents can do with RescueTime Automation
Add offline focus work
Logs time spent in focus mode when you weren't actively using a tracked application.
Archive project
Moves a project into an archived state or restores it to active status.
Cancel or stop focus session
Ends the current active focus session early.
Ask for historical activity data, category breakdowns, and efficiency reports using get_analytic_data.
Start or end an active Focus Session to block distractions; you can also extend the current duration with extend_focus_session.
Record activity that RescueTime didn't track, such as meetings (create_extra_work) or exercise (add_offline_focus_work).
Get a high-level summary of your day’s logged time and productivity pulse using get_daily_summary_feed.
List existing projects (get_projects), create new ones (create_project), or check progress against set objectives (get_goals).
Ask an AI about this
Waiting for input…
What AI agents can do with RescueTime MCP Server: 54 Tools for Productivity
Use these tools to query historical data, start/stop focus blocks, log activity, and analyze your time usage directly through your AI agent.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using RescueTime on VinkiusAdd Offline Focus Work
Logs time spent in focus mode when you weren't actively using a tracked application.
Archive Project
Moves a project into an archived state or restores it to active status.
Cancel Or Stop Focus Session
Ends the current active focus session early.
Create Alert
Sets a custom alert that notifies you when certain criteria are met.
Create Extra Work
Manually adds a time entry for non-core work tasks, like unexpected calls or admin...
Create Goal
Sets a measurable objective you want to track your progress toward.
Create Project
Initializes a new project record within RescueTime.
Delete Timeline Activities
Removes bulk tracked time entries for a specified date range.
End Focus Time
Stops the active focus session (Premium feature).
Extend Focus Session
Increases the duration of a currently running Focus Session.
Get Accounts
Retrieves high-level information about account settings and permissions.
Get Alerts
Lists all active, user-defined alerts you have set up.
Get Alerts Feed
Fetches a running log of recently triggered custom alerts.
Get Analytic Data
Queries detailed historical data and productivity metrics for analysis.
Get Calendar Events
Lists calendar events synchronized with your RescueTime account.
Get Categories
Retrieves a list of all recognized activity categories.
Get Daily Summary Feed
Gets a high-level, pre-computed rollup of time logged for the day.
Get Daily User Summaries
Fetches pre-calculated daily summaries for multiple users in a team.
Get Devices
Lists all user machines (laptops, desktops) that have reported activity time.
Get Extra Works
Retrieves a list of manually created extra-work time entries.
Get Focus Sessions
Lists all persistent records and details about past focus sessions.
Get Focustime Ended Feed
Provides a log feed of all concluded Focus Sessions.
Get Focustime Started Feed
Provides a log feed of when Focus Sessions were initiated.
Get Goals
Retrieves the details and current status of defined goals.
Get Highlights Feed
Gets a premium feed showing your key productivity achievements for the day.
Get Managed Users
Lists all team members that you manage or oversee access for.
Get Meeting Events
Filters and lists events specifically classified as meetings from your calendar sync.
Get Organizations
Retrieves details about the organizational structure associated with the account.
Get Overview Tree
Pulls a personalized hierarchy view of activity data, including score overrides.
Get Overviews
Lists the top-level categories or buckets for your overall activity profile.
Get Productivities
Retrieves definitions and types of productivity scores available in the system.
Get Profile Entities
Lists settings where you have customized category or score overrides per account.
Get Projects
Retrieves a list of all defined projects and their current status.
Get Schedules
Lists your configured work schedules and availability times.
Get Tasks
Retrieves a list of tasks associated with projects or accounts.
Get Teams
Lists all team groups that the current user belongs to.
Get Timeline Activities
Fetches a normalized stream of activity data for a specific day.
Get User Settings
Retrieves user-specific settings that can be written to via the API.
Get Users
Fetches basic information and details about the current logged-in user.
Get Web Notification Counts
Checks the number of read or unread notifications in the system.
Get Web Notifications
Lists all recent in-app notification messages.
Log Project Time
Records a specific block of time and attributes it to a named project or task.
Merge Project Time
Combines two adjacent, separate time entries into one continuous record.
Opt In Beta
Changes your status regarding participation in beta feature testing.
Post Highlight
Creates a new daily highlight entry (Premium feature).
Post Offline Time
Logs general offline time blocks, excluding specific projects (Premium feature).
Register Live Activity
Registers push tokens required for Apple Live-Activity notifications.
Start Focus Session
Initiates a global focus session, signaling deep work time to the system.
Start Focus Time
Triggers a specific Focus Session period (Premium feature).
Start Focus Zone
Begins a designated 'Do Not Disturb' block for deep work.
Toggle Timesheet Finalized
Marks a specific date as finalized, locking the timesheet data from further changes.
Update User
Modifies your personal profile details or settings within RescueTime.
Update Web Notification
Marks an existing notification as read or dismisses it entirely.
Upsert Profile Entity
Updates or creates a custom activity score override for a specific application or site.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with RescueTime, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by RescueTime. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Built on the Model Context Protocol (MCP) for Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 54 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Time tracking shouldn't feel like a second job., Solved with Vinkius AI Gateway
Today, if you want to know where your time went last month, you have to jump between the RescueTime dashboard, export data into CSVs, and then open up Excel. You spend half an hour just cleaning the data before you can even start analyzing it.
With this MCP server, you skip all that friction. You simply ask your agent: 'Show me my time breakdown for Project Beta last month.' The agent uses `get_analytic_data` and delivers a structured summary immediately. It cuts out the spreadsheet step entirely.
Start Focus Sessions with RescueTime MCP Server
The old way was setting a physical timer, putting your phone on silent, and manually telling everyone in your Slack channel to leave you alone. It was an annoying process that required multiple steps just to get started.
Now, it’s one prompt: 'Start my deep work session.' The agent triggers `start_focus_session`. Distractions are blocked automatically, and the system handles the entire sequence—no manual toggling is needed.
What your AI can actually do with this
You're gonna connect your RescueTime account right into your AI agent. This server gives you total control over your time data, letting you track focus metrics and analyze exactly where you spend your hours—all without leaving your chat interface. Forget manually crunching CSVs or jumping between tabs; you just ask the agent for a report.
Analyzing Your Time and Productivity Metrics
You can run deep historical dives into your productivity using get_analytic_data, letting you query detailed metrics across specific date ranges and even break down activity by category. Need to see what score you're generating? The agent handles that via get_overviews and pulls context from defined productivities through get_productivities. You can also get a top-level view of your entire profile using get_overview_tree, which includes details on any score overrides you've set up.
For account setup, the server lets you check high-level settings with get_accounts and see who manages the structure via get_organizations. You can also get basic info on yourself or other team members using get_users or get_managed_users. If you need to know what time blocks were logged by different machines, run get_devices.
Mastering Focus and Deep Work Blocks
The server gives you robust control over your deep work periods. You can initiate a global focus session using start_focus_session, signaling that it's time for zero distractions. If you need more time in that zone, you can extend the current block with extend_focus_session. When you wrap up, or if something changes, you end the active period via end_focus_time or by using cancel_or_stop_focus_session.
The agent logs every session start and stop for you—you get feeds of when focus time started (get_focustime_started_feed) and when it ended (get_focustime_ended_feed), plus a list of all previous sessions through get_focus_sessions. You'll also see when you worked offline, logging general blocks that aren't tied to a specific app using add_offline_focus_work or the premium post_offline_time.
Logging and Structuring Your Workday
The agent handles all the time entries RescueTime missed. You can manually add time for non-core jobs, like unexpected client calls, by running create_extra_work. If you need to attribute a specific block of time—say, a consulting gig or a side project—you use log_project_time to record it against a defined project or task.
You'll find that the server helps keep everything clean: if two work blocks butt right up against each other, you can merge them into one continuous entry with merge_project_time. For planning, you initialize new projects with create_project, list all existing ones via get_projects, or move an entire project to archive status using archive_project.
Tracking Goals and Managing Tasks
Want to know if you're hitting your targets? You set objectives by calling create_goal and then check progress with get_goals. The server also tracks the tasks linked to those projects through get_tasks, giving you a clear picture of where your efforts are focused. If there’s something specific happening on your calendar, the agent pulls that in for context using get_calendar_events or filtering strictly for meetings with get_meeting_events.
You can also see all team groups you belong to via get_teams, and if you're managing staff, you can view details about them through get_managed_users.
Daily Overviews and Alerts System
Getting a quick read on your day is simple. The agent pulls the high-level rollup of time logged for today using get_daily_summary_feed. For team environments, you can get pre-calculated daily summaries for multiple users with get_daily_user_summaries. You're always notified about critical items; you set up custom alerts by calling create_alert, and the agent lets you review them all using get_alerts or check the real-time feed through get_alerts_feed.
The system also keeps track of your notifications, letting you count unread messages with get_web_notification_counts or view them directly via get_web_notifications. For cleanup, if you need to delete large chunks of historical time data for a specific date range, run delete_timeline_activities, and when the day is done, you can lock the timesheet using toggle_timesheet_finalized.
019e5d4f-9cd6-71d6-866e-6b9c60dbbd0b Here's how it actually works
The bottom line is that you talk to your AI client like talking to a colleague who already has access to all your work logs.
Subscribe to the server and give your API Key. The AI agent connects this key to your RescueTime account.
You prompt the agent with a request (e.g., 'What was my productivity last Tuesday?').
The agent identifies the necessary tool (get_analytic_data), runs it, receives structured data, and replies in plain English.
Who is this actually for?
Knowledge workers, consultants, and project managers who spend time switching between logging tools, calendars, and chat apps. If you’re tired of exporting data just to figure out where your last week went, this is for you.
Needs to track focused coding sprints against specific projects by using log_project_time and managing focus blocks with start_focus_session.
Must synthesize time data for multiple team members without running manual reports; uses tools like get_managed_users and get_analytic_data.
Requires precise records of billable hours. Uses add_offline_focus_work or create_extra_work to ensure every minute is accounted for on a specific project.
What Changes When You Connect
Stop manual reporting. Instead of exporting CSVs and spending an hour in Excel to calculate last week's focus hours, just ask the agent: 'What was my average productivity score for Q3?' The agent uses get_analytic_data and gives you a single number.
Maintain deep work flow without interruption. When you need 90 minutes of concentration, trigger it with start_focus_session. Your AI client handles the block, so you don't have to remember to turn off notifications or manually start a timer.
Keep your billing accurate even when you’re offline. If you spend an hour in a meeting that doesn't use tracked apps, you just call add_offline_focus_work and log the time against the correct project using log_project_time. No more guessing on invoices.
Get instant daily performance summaries. You don’t need to visit the dashboard every morning. A simple prompt gets the agent to run get_daily_summary_feed, giving you a clean, concise report of your logged time and productivity pulse right in chat.
Keep track of progress toward big goals. Instead of just seeing raw data, you can check if you’re hitting targets by calling get_goals. This tells you if the work you've done is actually moving the needle.
See it in action
Client billing review
A consultant finishes a week of diverse tasks. Instead of logging into RescueTime, exporting data, and manually calculating billable time, they ask their agent: 'Pull all logged time for Project Chimera this week.' The agent runs get_analytic_data and returns the total hours segmented by category, ready to copy directly onto an invoice.
Deep work interruption
A developer is in flow state but gets distracted by a chat message. They immediately tell their agent: 'I need 60 minutes of uninterrupted focus.' The agent executes start_focus_session, triggering the DND block and providing immediate confirmation, letting them get back to code.
Tracking non-work time
A manager realizes they forgot to log a two-hour personal development session. Instead of trying to remember which project it relates to, they use add_offline_focus_work and tag the entry as 'Professional Development', keeping their records complete.
Team accountability check
A team lead needs to know if a junior dev is hitting his assigned objectives. He asks: 'Check out John's progress on Goal X.' The agent runs get_goals and reports back the current status, eliminating the need for manual dashboard review.
The honest tradeoffs
Manual data aggregation
Downloading a week's worth of CSV files from RescueTime’s website and spending an hour in Excel just to calculate total time spent on 'Marketing' vs. 'Development'.
Don't download anything. Just prompt the agent: 'Give me a breakdown of all activities categorized as Marketing over the last 7 days.' The agent uses get_analytic_data and delivers the formatted report instantly.
Forgetting non-work time
Only logging billable work hours, completely forgetting to log necessary time for mandatory team meetings or personal development reading.
Don't just rely on tracked activity. Manually add the missing blocks using create_extra_work and tag them correctly. If it wasn't logged, it doesn't count.
Overwriting data
Needing to delete a large chunk of time accidentally logged last month, but not knowing which tool handles bulk deletion.
Don't try to manually edit dozens of entries. Use the delete_timeline_activities tool and specify the exact date range and records you need removed.
When It Fits, When It Doesn't
Use this server if your primary pain point is synthesizing complex, multi-source data into simple answers (e.g., 'How much time did I spend on X last month?'). The strength here is analysis (get_analytic_data) and immediate action (starting a focus block). Don't use it if you just need to view a basic calendar schedule—for that, standard calendar APIs are better. Also, don't rely on this for real-time operational data like server status checks; use dedicated monitoring tools for those tasks. This tool excels at historical reporting and behavioral modification (focus sessions).
Questions you might have
How do I check my productivity summary using get_daily_summary_feed? +
The agent runs get_daily_summary_feed and gives you a high-level overview of time logged for the day. It's great for quickly seeing your overall pulse without diving into specific activity types.
Can I log time against a project using log_project_time? +
Yes, that's exactly what it does. You tell the agent which project and how long you worked, and it creates a dedicated entry using log_project_time.
How do I start a focus session with start_focus_session? +
You just ask the agent to start one. It triggers the global Focus Session via start_focus_session, immediately blocking distractions so you can get back to work.
What is the difference between add_offline_focus_work and create_extra_work? +
Use add_offline_focus_work for general, non-project time blocks (like reading or personal admin). Use create_extra_work when you need to log a specific type of task that is related to project work.
Does get_analytic_data track team members? +
It tracks activity data, and if your account supports it, the agent can query summaries for managed users using get_managed_users before running the analysis.
If I have multiple time entries for the same block of work, how do I use `merge_project_time`? +
It automatically combines adjacent time blocks into one entry. Use this tool when your activity log shows several small logs for a single continuous task; merging them keeps your data clean and accurate.
How do I check the defined scope of my work using `get_projects`? +
This function lists all your configured projects. You can use this list to see the top-level containers for your logged time, helping you understand where different types of activity are categorized.
What is the specific process for stopping an active focus session using `cancel_or_stop_focus_session`? +
It immediately ends the current Focus Session and logs the termination event. This tool lets you manually stop a work block when your priorities shift, ensuring accurate time records.
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.
We've already built the connector for RescueTime. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 54 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.