# Todoist MCP > Todoist MCP connects your personal and team to-do lists directly into your AI agent. This allows you to manage everything from simple task creation to complex project status checks, all through natural conversation. Forget opening the app and clicking through menus; simply tell your agent what needs doing—whether it's marking something complete or listing every label attached to a whole department project. It keeps your entire workload organized without ever leaving your chat client. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** task-management, to-do-list, workflow-automation, task-prioritization, project-tracking, reminders ## Description Managing tasks usually means juggling multiple apps: checking off items in one place, reviewing status updates in another, and compiling summaries in a third. This MCP changes that. You connect your Todoist account to any AI agent, giving it the ability to read and write directly into your life's command center. Instead of clicking through complicated project views or filtering tasks by date ranges, you just ask for what you need. Your agent can list all your projects, pull up every section within them, and even fetch a running list of comments attached to specific items. If a task is done, it's not gone; you can tell your agent to reopen it or get full details about its metadata. The whole system works together, making complex organizational tasks feel like simple conversations. When you use this MCP through Vinkius, the entire catalog of tools becomes available to your AI client, meaning you don’t just manage tasks—you control your entire workflow from one place. ## Tools ### complete_task Marks an existing task as finished within Todoist. ### create_project Sets up a brand new project container in your account. ### create_task Adds a single, specific to-do item to your list. ### get_project_details Retrieves detailed metadata and structure for an entire project. ### get_task_details Gets all the specific information associated with one single task item. ### list_comments Pulls up a list of notes and discussions attached to either a task or an entire project. ### list_all_labels Shows you all the custom labels you've set up across your projects. ### list_projects Lists every major project container currently in your Todoist account. ### list_project_sections Displays all the organized sections that belong inside a specific project. ### list_active_tasks Retrieves a list of currently active tasks, allowing you to filter by label, project, or custom criteria. ### reopen_task Changes the status of a completed task back to active so it can be revisited. ### update_task_details Modifies specific information on an existing task, like changing due dates or priority levels. ## Prompt Examples **Prompt:** ``` What are my high priority tasks for today? ``` **Response:** ``` I've checked your active tasks. You have 2 high priority items (P1) for today: 'Finalize presentation' and 'Call client about API update'. Would you like to mark either as complete? ``` **Prompt:** ``` Create a task in the 'Work' project: 'Submit expense report' due Friday at 5pm. ``` **Response:** ``` Success! The task 'Submit expense report' has been added to your 'Work' project (ID: 10293) and is scheduled for this Friday at 5:00 PM. ``` **Prompt:** ``` Show me all active tasks with the label '@errand'. ``` **Response:** ``` I've fetched the tasks. You have 3 active items with the '@errand' label: 'Buy groceries', 'Post office', and 'Pick up dry cleaning'. Shall I retrieve the details for the post office task? ``` ## Capabilities ### Create and Update Tasks Add new to-do items or modify existing ones, setting due dates, priorities, and detailed notes. ### Manage Projects and Sections List all your primary projects, create brand new ones, and see the specific sections within any given project structure. ### Track Task Status Mark tasks as complete or reopen items that were previously marked as finished for review. ### Query Tasks by Filter and Label Find active tasks quickly, filtering them down by specific labels (like '@errand') or using Todoist's built-in filter syntax to focus on today's items. ### Review Project Communication List all comments and discussions tied to either a project or an individual task, keeping your notes centralized. ## Use Cases ### The Quarterly Review A Project Manager needs a status report for the 'Marketing' initiative. Instead of opening the project, navigating sections, and manually compiling task lists, they prompt their agent: 'Show me all active tasks in Marketing with P1 priority.' The MCP uses list_active_tasks to deliver an immediate, actionable summary. ### The Quick Brain Dump A busy professional just remembered a task. Instead of trying to remember which project it belongs to, they ask their agent: 'Create a new task called 'Call Accountant' and set the priority to P1.' The MCP uses create_task, logging the item instantly. ### Following Up on Feedback After a client meeting, you need to follow up on three separate items. You ask your agent: 'List all tasks related to the client feedback label.' The MCP uses list_active_tasks and can then fetch details for each task using get_task_details. ### Project Reorganization A project is paused, but you need to keep track of its notes. You ask your agent to retrieve the full metadata for the 'Client X' project using get_project_details. This gives you a structural overview without needing to open the actual project board. ## Benefits - Stop manually checking task statuses. You can ask your agent to list active tasks, filtered by a label or project name, giving you an instant, comprehensive status report without opening the app. - Project structure becomes transparent. Use the ability to list projects and sections so your AI client always knows exactly where a specific piece of work belongs in your overall plan. - Keep track of history effortlessly. You can review all comments on any project or task by asking to list comments, ensuring no critical discussion point gets lost in email threads. - Handle the whole lifecycle of a to-do item. If something is finished early, you don't have to delete it; you just ask your agent to reopen the task for future reference. - Get complete visibility on your work. The ability to list all labels and get project metadata means you can query tasks based on complex criteria that used to require tedious manual filtering. ## How It Works The bottom line is you use your AI client's natural language ability to control the structured data inside Todoist without ever leaving your chat interface. 1. First, you subscribe to this MCP on Vinkius and provide your Todoist API Personal Access Token in the developer settings. 2. Next, you interact with your AI client using natural language prompts—asking questions like 'What are my P1 tasks for today?' or 'Create a project called Marketing Q3.' 3. Finally, your agent uses these commands to execute actions within Todoist, and it reports back the status of your task list directly into your chat window. ## Frequently Asked Questions **How do I use Todoist with my agent using the Todoist MCP?** You first subscribe to this MCP on Vinkius and connect your personal access token. Then, you ask your AI client in plain English what task action you want performed. **Can I see all my projects with the list_projects tool?** Yes, calling list_projects retrieves a comprehensive list of every major project container available in your Todoist account right from your agent. **Does this MCP let me filter tasks by label?** Absolutely. You can use the list_active_tasks tool to filter results based on any custom label, like finding all items tagged with '@errand'. **What if I need to change a task's due date? Which tool do I use?** You use the update_task_details tool. Your agent will prompt you for the specific task ID and the new details, allowing you to modify anything from priority to deadline. **Does this MCP help me track project discussions?** Yes, by calling list_comments, your agent can pull up all historical notes and comments associated with either a specific task or the entire parent project.