# Reclaim.ai MCP > Reclaim.ai equips your AI agent to manage tasks, habits, and scheduling directly through your calendar. It acts like a proactive executive assistant; you tell it 'block time for X,' and it handles the smart placement across Google Calendar. This server lets your AI client read your availability (`list_calendar_events`), track recurring routines (`list_habits`), create dynamic tasks (`create_task`), or pull usage data to see exactly how you spent last month's focus blocks. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-blocking, task-management, smart-scheduling, habit-tracking, calendar-automation, work-life-balance ## Description Listen up. This server—the Reclaim.ai MCP Server—hooks your AI agent right into your professional calendar and task list. It turns your client from just a chatbot into a real executive assistant that handles complex scheduling without you having to manually copy-paste anything. When you're set up with this, you can control everything from setting priorities to pulling analytics on where you actually burn time last month. **Creating and Adjusting Tasks:** Your AI client uses `create_task` when it needs to book a new item on your calendar. You just give it the title, how long it'll take in minutes, the due date, and what priority level—P1 through P4—it has. Reclaim handles the smart placement automatically so you don't clash with anything else already booked. If that task needs to change, you can use `update_task` to modify any of its parameters using a JSON payload. And if it’s trash and you gotta ditch it for good? You call `delete_task`. Don't forget, deleting a task is permanent; you won't get that back. **Reviewing Your Schedule History:** Need the full picture of your day? Call `list_calendar_events`, and it pulls every single thing scheduled on your planner for a date range—that includes events you manually booked *and* stuff your AI agent created. It gives you the whole story. To see what tasks are floating around, check `list_tasks`. This lists everything Reclaim manages and lets you filter by status: NEW, SCHEDULED, IN_PROGRESS, or COMPLETE. If you wanna know exactly what details a specific task has—maybe you need to verify the original due date or priority—you use `get_task` with just that single Reclaim.ai task ID. You can also confirm who's making the request by running `get_current_user`, which pulls your basic profile data. **Tracking Habits and Routine Time:** If you wanna make sure those deep work sessions or core routines actually stick to the schedule, run `list_habits`. This shows you all the recurring, protected time blocks (Habits) that are set up in Reclaim.ai. Want to send out your booking link fast? `list_scheduling_links` pulls and lists all those shareable booking page URLs so you can drop them into a chat with clients or teammates immediately. **Analyzing Time Allocation:** You don't just get event names; you get hard numbers. You use `get_analytics` to pull detailed time reports, showing exactly how many hours you allocated focus across different activity categories over any specific date range you pick. It tells you where your time actually went. **The rundown is this:** Your agent uses these tools together. It can list all the tasks using `list_tasks`, check what events are booked via `list_calendar_events`, and then, if it needs to schedule something new, it'll call `create_task`. If you need to know what those habits look like, you run `list_habits` before you even think about calling `get_analytics` for a report. You can also pull your profile data with `get_current_user` just to make sure the whole thing is running under the right user context. ## Tools ### create_task Creates a new, auto-scheduled task by specifying the title, duration in minutes, due date, and priority (P1 to P4). ### delete_task Permanently removes an existing task from Reclaim.ai; this action cannot be undone. ### get_analytics Retrieves detailed time analytics, showing how you allocated focus across different categories for a specific date range. ### get_current_user Pulls the profile details of the user who is currently authenticated to the server. ### get_task Retrieves all specific details for a single, existing Reclaim.ai task ID. ### list_calendar_events Lists every event scheduled on your planner for a defined date range, regardless of who created it. ### list_habits Retrieves a list of all recurring protected time blocks (Habits) that are set up in Reclaim.ai. ### list_scheduling_links Lists and retrieves your shareable booking page URLs, letting you send them to clients or teammates instantly from chat. ### list_tasks Lists all tasks managed by Reclaim.ai, allowing filtering by status (NEW, SCHEDULED, IN_PROGRESS, COMPLETE). ### update_task Modifies an existing task's parameters using a JSON object payload. ## Prompt Examples **Prompt:** ``` Create a new task to draft the Q3 analytics report taking 3 hours with P1 priority. ``` **Response:** ``` I submitted the `create_task` command for your Q3 analytics report (duration: 180 min, priority: P1). Reclaim has successfully added it to your backlog and is actively attempting to secure dedicated focus blocks on your calendar before any deadlines. ``` **Prompt:** ``` Delete task with ID 20392. ``` **Response:** ``` Using the `delete_task` operation, I have permanently removed the task with ID 20392. Note that any calendar holds or events associated solely with this auto-scheduled task have also been cleared from your calendar. ``` **Prompt:** ``` Show my time spent analytics between 2024-01-01 and 2024-01-31. ``` **Response:** ``` I requested your statistical summary via `get_analytics`. During January 2024, you dedicated roughly 84 hours to 'Deep Work', spent 30 hours locked in manual multi-participant meetings, and sustained your 'Reading' habit strictly spanning 12 aggregate hours across 20 distinct days. ``` ## Capabilities ### Create and Adjust Tasks Your AI client creates new tasks with specific priorities and durations, automatically scheduling them onto your calendar. ### Track Habits and Routines You list all recurring, protected time blocks (Habits) to ensure deep work sessions or routines stay on the schedule. ### Analyze Time Allocation The agent pulls quantitative reports using `get_analytics`, showing how many hours you spent on different activity categories over a custom timeframe. ### Review Calendar History You retrieve every event—both manual and AI-created—for any given date range, giving a complete view of your schedule. ### Manage User Context The server can pull basic user profile data using `get_current_user` to confirm who is making the scheduling requests. ## Use Cases ### The end-of-month time audit. You just finished a big project, but you need proof of where your focus went. Instead of digging through scattered meeting notes, you ask the agent to run `get_analytics` for last month. The server returns specific data: 84 hours in 'Deep Work,' 30 hours in meetings, and 12 hours reading—a perfect audit trail. ### The urgent conflict resolution. You get a meeting request that conflicts with your planned deep work. You tell the agent to run `create_task` for the new meeting time, but also specify high priority. The system checks your existing schedule and either blocks out enough time or flags the conflict immediately. ### The developer sprint planning. You're in a coding session, reviewing sprints. You tell the agent to create three new tasks for the week using `create_task` (e.g., 'Fix Authentication', 4 hours, P1). The agent feeds these parameters and blocks them out across your calendar immediately. ### The client booking link share. A potential client asks for a meeting time in the chat window. You don't have to open Reclaim.ai; you ask the agent to run `list_scheduling_links`. It instantly retrieves and sends your specific, up-to-date booking URL. ## Benefits - Stop guessing your availability. Use `list_calendar_events` to see every scheduled item—manual meetings, AI blocks, everything—for a given date range. You get the full truth of what’s on your plate. - Track time accurately instead of just seeing events. Running `get_analytics` gives you quantitative data showing exactly how many hours you spent in 'Deep Work' versus 'Meetings' across months, not just rough estimates. - Automate focus blocks instantly. Instead of manually blocking out 3 hours, tell your agent to run `create_task` with P1 priority. Reclaim handles the conflict resolution and placement automatically. - Keep communication clean. Need a meeting link? Use `list_scheduling_links` to retrieve and send your shareable booking URL directly from chat—no copy-pasting necessary. - Manage team capacity. If you're loading tasks for others, use `create_task` or `update_task` to ensure the AI balances individual workloads before conflicts happen. ## How It Works The bottom line is: it lets your AI client treat scheduling like a native function, giving you command-line control over your entire professional calendar. 1. First, authorize the Reclaim.ai MCP server and provide your API Key in the Vinkius dashboard. 2. Next, ask your AI client to perform an action—for example: 'Block 3 hours for a Q4 review with P1 priority.' 3. The agent executes `create_task`, sending the parameters (duration, title, priority) directly to Reclaim.ai, which then attempts to find and secure available time slots in your calendar. ## Frequently Asked Questions **How do I use the `create_task` tool with Reclaim.ai?** You specify the title, desired duration in minutes, due date, and priority (P1-P4). Example: 'Create a task to draft Q3 report taking 180 min with P1 priority.' The agent handles the API call. **What does `get_analytics` show me?** `get_analytics` returns quantitative data about your time allocation. It shows how many hours were dedicated to different categories (like 'Deep Work') within a date range you specify. **Can I delete tasks using the `delete_task` tool?** Yes, you can. Using `delete_task` permanently removes a task ID from Reclaim.ai. Be careful—any related calendar holds are also cleared. **How do I check my habits with the `list_habits` tool?** Running `list_habits` retrieves all your protected, recurring time blocks. This lets you verify that essential routines or deep work sessions are properly configured in Reclaim. **Is there a way to retrieve my booking links using the `list_scheduling_links` tool?** Yes, running `list_scheduling_links` instantly retrieves your shareable booking page URLs. You can then send them directly in chat without leaving the conversation. **How do I check if my Reclaim.ai integration is connected using the `get_current_user` tool?** The tool confirms your active connection and user profile details. It verifies that your AI client has proper read access to the account data, letting you know immediately if credentials are valid or need updating. **If I need more specific information about one task, how do I use the `get_task` tool?** The tool pulls all metadata for a single task ID. You get the title, priority level, duration, and due date—all in one place without having to list every scheduled item first. **How do I filter my tasks by status using `list_tasks`?** You specify a status (like NEW or COMPLETE) when calling the tool. This narrows the results, so you only see tasks that are waiting for action or those marked as done. **Where do I obtain my Reclaim API Key?** Log into your Reclaim.ai web application. Head towards 'Settings', select 'Integrations' from the sidebar, and look for 'API' at the bottom of the connected apps. Generate your personal token there and provide it using the setup authorization parameter below. **Does creating a task automatically schedule it on my calendar?** Yes. When the AI uses the `create_task` tool, Reclaim.ai takes your input duration, designated priority (P1 to P4), and due date to contextually slot it securely into an available window on your connected Google or Outlook calendar without extra prompts. **Can I query what was already booked in the past by AI vs manually added?** Yes. The `list_calendar_events` query imports event types accurately across any given time period, allowing the AI to effectively understand both the manual meetings you accepted and the tasks Reclaim auto-negotiated on your schedule.