# Todoist MCP for AI Agents AI Agent Connect > Todoist MCP lets you manage your tasks and projects through your AI client. You can add new to-dos, check your schedule, and organize projects without leaving your chat or IDE. It handles priorities, due dates, and labels, making it easy to keep your personal and team workflows in sync. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_HfQRZUA1FVTeCGmOm2bX11VlRIjnWwFHWOWvVowT/ai-agent-connect - **Tags:** task-management, to-do-list, workflow-automation, task-prioritization, project-tracking, reminders ## Description Managing a massive to-do list often feels like a second job. You spend more time moving cards around and updating dates than actually doing the work. This Connector changes that by letting your AI agent handle the heavy lifting. Instead of jumping between tabs to find that one specific task or manually creating a new project for a client, you just tell your agent what needs to happen. It understands Todoist's specific logic, so you can ask it to find high-priority items for today or group new tasks into the right project sections instantly. It's like having a personal assistant who lives inside your workspace and keeps your schedule tidy. When you connect this to your existing setup through the Vinkius catalog, your AI stops being just a chatbot and starts being a functional part of your productivity stack. You can check your labels, read through project comments, or reopen old tasks just by talking. It keeps your life organized without the friction of manual data entry. You no longer have to worry about whether you remembered to move a task to the correct folder or if you missed a deadline because a notification didn't pop up. Your agent acts as the bridge between your thoughts and your actual organized list. Whether you are trying to clear out your inbox, plan a complex product launch, or just make sure you remember to pick up the dry cleaning, this connection ensures that your tasks stay where they belong. It turns your static list into a dynamic, interactive workspace where you can query your data, update your progress, and see the big picture without ever having to click a single button. ## Tools ### complete_task Marks a specific task as finished in your list. Use this to clear items off your plate once done. ### create_project Sets up a new project container for your work. This helps keep different workstreams separated. ### create_task Adds a new to-do item with any necessary details. Tell your agent the title, date, and priority. ### get_project_details Fetches metadata for a specific project. This helps you see the high level details of a project. ### get_task_details Pulls the full description and info for one task. Use this to see the full context of a specific item. ### list_comments Shows all notes and discussions on a task or project. This is great for checking team feedback. ### list_all_labels Shows every personal label you've created. Use this to see how your tasks are categorized. ### list_projects Shows a list of all your current projects. This provides a bird's eye view of your work. ### list_project_sections Shows the different sections inside a project. Use this to see how a project is structured. ### list_active_tasks Shows your current to-dos, filtered by project or label. This helps you see what needs to happen now. ### reopen_task Changes a completed task back to an active state. Use this when a finished task actually needs more work. ### update_task_details Modifies the details of an existing task. Use this to change a deadline or update a description. ## 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: | Task | Priority | Status | | :--- | :--- | :--- | | **Finalize presentation** | P1 | Active | | **Call client about API update** | P1 | Active | Would you like me 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 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 * 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 with specific due dates and priorities. ### Manage project structures Build out project folders and organize them into specific sections. ### Filter tasks using Todoist syntax Query your active list using specific filters like 'today' or 'p1' for high priority items. ### Organize with labels List and manage personal labels to tag your tasks across different projects. ### Track discussions Fetch comments on tasks or projects to see notes and team feedback. ### Manage task status Mark tasks as finished or reopen completed items that still need attention. ## Use Cases ### Adding client tasks on the fly A freelancer needs to add a task for a specific client. They tell their agent to 'Create a task in the Client X project for Send Invoice due tomorrow' and it appears instantly. ### Reviewing daily priorities A manager needs to see what's left for the day. They ask their agent 'What are my high priority tasks for today?' to see a filtered list of P1 items. ### Checking team feedback A user wants to see what people said about a project. They ask their agent to 'Show me the comments on the Website Redesign project' to get all the latest notes. ### Correcting a finished task Someone needs to move a finished task back to active because it's still broken. They tell their agent to 'Reopen the task Fix login bug' to put it back on their list. ## Benefits - Stop manual data entry by using `create_task` to add items via voice or text directly into your list. - Get a bird's eye view of your workload using `list_active_tasks` with filters to see what matters most. - Keep projects organized by using `create_project` and `list_project_sections` to structure your work. - Stay updated on team feedback by pulling project notes with `list_comments` without leaving your chat. - Easily categorize work across different areas by managing your tags with `list_all_labels`. - Quickly adjust your schedule by using `reopen_task` or `complete_task` to update your progress in real time. ## How It Works The bottom line is you get a hands-free way to manage your entire Todoist workspace from your preferred AI client. 1. Subscribe to the Todoist MCP on the Vinkius Marketplace. 2. Provide your Todoist API Personal Access Token in the configuration. 3. Start giving your AI client commands to manage your list. ## Frequently Asked Questions **Can the Todoist MCP add tasks with due dates?** Yes, it can create new tasks with specific dates and times. You just need to tell your AI client when the task is due. **Does the Todoist MCP work with my existing projects?** Yes, it connects directly to your current projects and labels so you can manage your existing setup immediately. **Can I use the Todoist MCP to see my comments?** Yes, it can fetch and display comments from both tasks and projects, helping you stay on top of team discussions. **Can the Todoist MCP filter my tasks?** Yes, it supports Todoist's filter syntax. You can ask your agent to show you tasks for 'today', 'p1', or specific labels. **Is the Todoist MCP good for team projects?** Yes, it can manage projects and sections shared with your team, making it a great way to coordinate group work. **Can I reopen a task I already finished?** Yes, it has a specific tool to mark closed tasks as active again if you realize they still need some work. **Can I filter tasks for today using the AI?** Yes! Use the `list_active_tasks` tool and provide the `filter` parameter set to 'today'. Your agent will retrieve all tasks scheduled for the current date. **How do I add a new task to a specific project?** Use the `create_task` tool. Provide the content and the unique Project ID. You can also include a `due_string` like 'tomorrow at 10am' to set a deadline. **Is it possible to list all my labels via AI?** Absolutely. Run the `list_all_labels` query. The agent will retrieve the complete directory of labels you use to categorize tasks in your account.