# Todoist MCP > Todoist manages your tasks and projects by connecting directly to your favorite task manager. Your AI agent can list active tasks, audit project status, or create new items without you ever opening the Todoist app. It gives your workflow a real-time co-pilot for managing everything from personal errands to complex team deadlines. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-management, to-do-list, project-tracking, workflow-automation, personal-productivity, task-scheduling ## Description Connect Todoist to your agent and stop juggling multiple dashboards just to check off simple tasks. This MCP lets your AI client treat your entire to-do list like a natural conversation. You don't need to navigate menus; you just ask for what you need, and the information pops up. Need to know everything due next week? Ask. Want to update a task description because the meeting moved? Tell it. The agent acts like a dedicated project coordinator, keeping your goals organized automatically. When you connect Todoist via Vinkius, your entire productivity ecosystem becomes accessible through your AI client. You can list all projects and sections, get details on specific tasks, or even delete items that are no longer relevant. It keeps your task data current whether you're juggling personal life or managing a big team rollout. ## Tools ### close_task Marks an existing task as finished. ### create_task Adds a brand new task to your list. ### delete_task Permanently removes a specified task. ### get_project Retrieves all detailed information for one specific project. ### get_task Gets the full details and metadata for a single, specified task. ### list_labels Displays all custom labels you've set up in your account. ### list_projects Shows a list of every project you currently have active. ### list_sections Lists all the sections contained within a chosen project. ### list_tasks Finds and lists tasks, allowing filtering by projects, labels, or specific text strings. ### update_task Changes the details of an existing task, such as its due date or priority. ## Prompt Examples **Prompt:** ``` List my tasks for today in Todoist. ``` **Response:** ``` I've retrieved your tasks for today. You have 3 items, including 'Finish report' and 'Call client'. Would you like the details for any of them? ``` **Prompt:** ``` Create a new task 'Buy groceries' for tomorrow morning. ``` **Response:** ``` Task created! 'Buy groceries' has been added to your Inbox with a due date of tomorrow at 9:00 AM. ``` **Prompt:** ``` Show me all my projects in Todoist. ``` **Response:** ``` You have 4 active projects: 'Work', 'Personal', 'Shopping', and 'Travel'. I can list the tasks inside any of these projects for you. ``` ## Capabilities ### Reviewing Your Workload You can list all active tasks and retrieve detailed information like due dates, priorities, and labels. ### Mapping Project Structures It retrieves a full hierarchy of your responsibilities by listing all projects and the sections within them. ### Modifying Task Statuses You can create new tasks, update details on existing items, mark things as complete, or delete stale entries using natural language commands. ### Tracking Account Totals The MCP gives you a quick count of all your current tasks across the entire account. ## Use Cases ### Quickly compiling a weekly status report. A project manager needs to compile a status update for stakeholders. Instead of running separate reports from multiple dashboards, they ask their agent to list all projects and then use the `list_tasks` tool, filtering by 'due this week'. The agent compiles the necessary task details into one clean summary. ### Handling unexpected schedule changes. A busy professional gets a last-minute client call reschedule. Instead of logging in and manually finding the old task, they ask their agent to update the task using `update_task`, specifying the new time and date, keeping their list current instantly. ### Onboarding a new team member. An operations lead needs to show a new hire the structure of the department's work. They ask the agent to run `list_projects` followed by `list_sections`, giving the new employee an instant, comprehensive view of the entire project taxonomy. ### Cleaning up old or irrelevant tasks. At the end of a quarter, a user needs to declutter their list. They ask the agent to review all projects and identify completed items using `list_tasks`, then use `delete_task` on bulk-archived items. ## Benefits - You keep up with task flow without manual logging. Instead of clicking into a project just to see what's next, you simply ask your agent for an overview or use the `list_tasks` tool to get filtered results immediately. - Project oversight is instant. By using `list_projects` and then `list_sections`, your agent gives you a clean map of your entire workflow structure, letting you see exactly where everything lives without getting lost in menus. - Updating tasks takes seconds. If the meeting moves, don't open the app; just tell your agent to use the `update_task` tool and adjust the due date or description. It handles the change for you. - Full lifecycle control is here. Need to clear out old items? The combination of `create_task`, `delete_task`, and `close_task` lets you manage the task life cycle right where you're working. - Your workload count is always visible. Use account auditing tools to quickly retrieve overall task counts, giving you an immediate sense of how much you’ve got on your plate. ## How It Works The bottom line is that once it's connected, your agent can manage all of your tasks using plain conversation. 1. Subscribe to this MCP and provide your Todoist API token. 2. Connect the service to your preferred AI client (like Cursor or Claude). 3. Ask your agent a question, such as 'What projects need attention?' The MCP handles the request and delivers structured task data back to you. ## Frequently Asked Questions **Can I use Todoist with my AI client for team coordination?** Yes. You can list all projects and sections to give your agent a full view of the organizational structure, making it easy to coordinate tasks across teams. **How do I update a task using Todoist MCP?** You use the `update_task` tool by telling your agent exactly what needs changing—like moving the due date or adding a new description—and it applies the change to the record. **Does listing tasks require me to know all the project IDs?** No. You can ask your agent to use `list_projects` first, and then reference those names when asking it to run `list_tasks`, making the process straightforward. **What if I want to audit my account's total workload?** The MCP allows you to quickly retrieve your account-wide task counts, giving you an immediate understanding of your current overall workload. **Can I delete tasks using the Todoist MCP?** Yes. If a task is obsolete or was misfiled, you can use the `delete_task` tool to remove it from your list permanently via natural language instructions.