# Ellie Planner MCP MCP > Ellie Planner lets your AI client take over daily task management and time-blocking. Instead of jumping between tabs, you talk to your agent to create tasks, mark items as finished, or check on project status. It keeps track of everything in your brain dump and organizes it into structured lists and labels. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** ellie-planner, task-management, time-blocking, brain-dump, todo-api, personal-productivity, daily-planning, mcp ## Description Managing a complex schedule shouldn't mean switching between five different browser windows. This MCP connects your personal productivity system directly to your agent, letting you handle tasks through natural conversation. You can tell it to create an idea as a task, or ask it to check the status of something you started last week. It manages everything from basic daily checklists to complex project timelines, keeping track of which labels apply and what needs to be done next. If you're already using Vinkius for other services, adding Ellie Planner means getting one central point for managing your day without ever leaving your workflow. Your agent becomes a dedicated coordinator, allowing you to update task statuses or adjust deadlines just by asking. It handles the details—like making sure every thought gets labeled correctly and placed in the right list—so you can focus on the work itself. ## Tools ### complete_task Marks a specified task within your planner as finished. ### create_task Adds a new task to your plan, letting you include an optional due date or labels with the title. ### delete_task Permanently removes a task from your planner. ### get_task Retrieves all details for one specific, named task. ### list_labels Shows every custom label you've created and used in your planning process. ### list_lists Retrieves a complete list of all task categories (or 'Lists') you maintain. ### list_tasks Provides an inventory view of every active task in your planner. ### update_task Modifies the details, priority, or date of an existing task. ## Prompt Examples **Prompt:** ``` List all my current tasks for today in Ellie Planner. ``` **Response:** ``` I've retrieved your tasks for today. You have 5 active items, including 'Finish API Design' and 'Team Meeting'. Which one should we update or mark as completed? ``` **Prompt:** ``` Create a task 'Research MCP Servers' in my Brain Dump. ``` **Response:** ``` Done! I've added 'Research MCP Servers' to your Brain Dump list. It's now ready for you to schedule or prioritize later. ``` **Prompt:** ``` Mark task ID 't_123' as completed. ``` **Response:** ``` Action complete! Task t_123 has been successfully marked as completed in your Ellie Planner. Your progress is now updated on the dashboard. ``` ## Capabilities ### Generate new tasks Tell your agent to create a task, giving it a title and optionally setting due dates or labels. ### Change task status Mark an existing item as complete or modify its priority and deadline with simple instructions. ### Find specific tasks Ask for the details of one particular task, confirming exactly what it is and when it's due. ### Review organization structure Get a full directory listing all available labels or all existing project lists in your plan. ### View task list inventory List every single active task across your entire planner to see what's on the table. ## Use Cases ### The week-end brainstorming session A consultant has 50 random ideas. Instead of writing them down on sticky notes, they ask their agent to create a task for each idea using the 'Brain Dump' capability. The agent structures these raw inputs into new tasks, ready for the next phase of organization. ### The progress check-in A Project Manager needs to update 12 team members on their task status across three separate projects. They ask the agent to list_tasks and then use complete_task for each completed item, updating the dashboard without opening the planner app. ### The urgent scope change A Product Owner realizes a deadline is impossible. Instead of logging into Ellie Planner, they ask their agent to update_task on the specific feature, extending the due date and lowering its priority in one command. ### Onboarding new hires A team lead needs to show a new hire how tasks are organized. They ask the agent to list_lists first, then use list_labels to explain the categorization system before showing them how to get_task on an example item. ## Benefits - Stop manually switching between browser tabs. Your agent handles task creation, updating status, and retrieving details—all in one chat window. - Keep track of your ideas without losing them. Use the brain dump capability to instantly turn random thoughts into structured, actionable tasks. - Never lose context on a project again. You can list all labels or check every single task across your planner just by asking your agent. - Manage complex changes effortlessly. Instead of finding and editing an item, use the update_task tool to adjust deadlines or priorities instantly. - Maintain clean data integrity. Need to remove a bad idea? Use delete_task and keep your plan tidy without manually deleting it in the UI. ## How It Works The bottom line is: your AI acts like a personal assistant that lives inside your chat window, managing your schedule instantly. 1. First, subscribe to this MCP and grab your API Token from Ellie Planner settings. 2. Second, connect that token in your preferred agent client (Claude, Cursor, etc.). 3. Third, you just talk to it. Ask your agent anything—'What tasks did I set for today?' or 'Mark the API design task as done.'—and get an immediate update. ## Frequently Asked Questions **How do I update task status using the update_task tool?** You tell your agent exactly what needs changing. For example, 'Update task X: extend the deadline to Friday and mark it high priority.' The agent handles the rest of the data structure changes. **Can I list all my current tasks for today in Ellie Planner?** Yes, your agent can run the list_tasks tool. It gives you an inventory view and helps pinpoint which items need attention or completion right now. **Is there a way to create multiple related tasks at once? (create_task)** Yes, simply provide all the titles when asking your agent to run create_task. You can add them to specific labels like 'Phase 2' or assign them to different lists. **What if I want to delete a task but need proof first? (get_task)** Before deleting, always use get_task. This pulls up all the current details, letting you confirm that it is truly the item you want gone before running the delete_task command. **Before I start creating tasks, how do I use `list_labels` to see all the organizational labels available in my account?** It immediately retrieves a list of every label applied across your plan. This lets you check which categories are already set up, ensuring your new task fits into the right structure from day one. **What if I need to know what project lists or folders exist before I use `create_task`?** Running `list_lists` pulls a full directory of every custom list you've created. You can confirm the correct container name, which prevents errors when creating new tasks in specific projects. **If I try to run `update_task` but provide an incorrect task ID or status value, what happens?** The MCP will return a clear error message detailing the problem. This tells your AI agent exactly which piece of data is wrong so you can fix it and retry without guesswork. **How do I use `list_tasks` to pull a complete history or archive dump, rather than just today’s items?** You specify the desired date range in the prompt. This retrieves all tasks within that period, giving you a comprehensive view of your project's full timeline and historical progress. **How do I find my API Token?** Log in to your account, go to Settings, enable the 'Toggle power features' option, and you will see the API Token field. **Is a Pro plan required?** Yes, API access and automation features are exclusively available for Ellie Planner Pro subscribers. **Can the agent manage my labels?** The agent can list your labels using the `list_labels` tool. To create or edit labels, please use the Ellie Planner web application.