# Todoist MCP for AI Agents AI Agent Connect > Todoist MCP for AI Agents. Manage your tasks, organize projects, and handle your daily to-do list directly through your AI client. Stop jumping between tabs to check your schedule or add chores; do it all in one conversation. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_vVH6t9nrV7ThzNErR9cditaPcCpiXaBU7SFobEsE/ai-agent-connect - **Tags:** task-management, to-do-list, workflow-automation, task-prioritization, project-tracking, reminders ## Description Connect your account to any AI agent and bring your daily productivity directly into your chat. View your active tasks, manage projects, and quickly add new items to your workflow entirely through conversational commands without ever needing to open the app. Instead of jumping between tabs, you can see your project folders, retrieve specific IDs, and view sections within specific projects. You can see your complete list of pending tasks and mark them as completed instantly. It allows you to add new items to a specific project or your inbox naturally in plain conversation. You can also look up available labels to categorize your work or read through existing comments to catch up on discussion history. This is a massive shift for anyone who feels overwhelmed by a cluttered inbox or a disorganized project board. You can keep your focus on the work at hand while your agent handles the logistical heavy lifting of updating your list. This means you won't have to worry about whether you remembered to log that specific chore or project milestone. You can maintain a clean, accurate record of your progress without the friction of manual data entry. When you're looking for a way to manage your personal or team productivity without the friction of manual data entry, this is the right connection. You can find this and thousands of other tools in the Vinkius catalog to build out your custom workspace. ## Tools ### create_project Create a new project ### get_project_details Get metadata for a project ### get_task_details Get details for a specific task ### list_all_labels List your personal labels ### list_project_sections List sections within a project ### list_active_tasks Can filter by project, label, or filter. List active tasks ### reopen_task Mark a closed task as active ### update_task_details Modify an existing task ### complete_task Mark a specific task as finished instantly. It helps you clear your list as you work. ### create_task Add a new task to your inbox or a specific project folder. You can do this with a simple voice or text command. ### list_comments Read through the discussion history on a specific task. This keeps you caught up on team notes without opening the app. ### list_projects View all your active project folders at once. It gives you a high-level look at your current workload. ## Prompt Examples **Prompt:** ``` What's on my plate for the 'Work' project today? ``` **Response:** ``` I've pulled up your active tasks for the **Work** project. Here is what's currently pending: | Task Name | Priority | Status | | :--- | :--- | :--- | | 📝 Draft Q3 Report | High | In Progress | | 📧 Email stakeholders | Medium | To Do | | ⚙️ Update project board | Low | To Do | ``` **Prompt:** ``` Add a task to my inbox to buy milk. ``` **Response:** ``` Done! I've added **'Buy milk'** to your Todoist inbox. ``` **Prompt:** ``` Mark task 81229 as done. ``` **Response:** ``` I've successfully marked task **81229** as completed in your Todoist workspace. ``` ## Capabilities ### Finish tasks instantly Mark a specific task as completed with a single command. ### Add tasks to projects Create new items in your inbox or specific project folders via chat. ### View project folders See all your active projects and their specific IDs at a glance. ### Browse project sections Look inside a project to see all its organized sections. ### Check custom labels Retrieve all your user-defined labels to keep your work categorized. ### Read task comments Catch up on discussion history for any specific task. ### List pending actions Get a full list of active tasks, filtered by project if needed. ## Use Cases ### Logging bugs during a coding session A developer remembers a bug and says, 'Add a bug fix task to the Website project.' The agent uses `create_task` to log it immediately. ### Checking project status in a meeting A manager asks, 'What tasks are pending in the Marketing project?' and gets a filtered list using `list_tasks`. ### Quickly clearing finished chores A freelancer finishes a meeting and tells their agent to 'Mark the Draft Blog task as complete' using `complete_task`. ### Organizing new project categories A student wants to see their study tags and asks the agent to list all labels to see how they can categorize new notes. ## Benefits - Stop context switching by handling your tasks directly in your chat. - Use `create_task` to add items to specific projects without leaving your current conversation. - Keep your projects organized by using `list_projects` and `list_sections` to see your structure. - Stay updated on team discussions by reading history with `list_comments`. - Quickly clear your plate by using `complete_task` to mark items done. - Better categorize work by pulling up your custom tags with `list_labels`. ## How It Works The bottom line is you get a conversational interface for your entire task list without leaving your chat. 1. Subscribe to the Todoist MCP on Vinkius. 2. Generate your personal API Token from your Todoist integrations page. 3. Plug the token into your AI client and start asking questions. ## Frequently Asked Questions **Can I use the Todoist MCP to organize my project folders?** Yes, this Connector allows your agent to list all your active projects and see the specific sections within them, making it easy to keep your workspace organized. **How do I add new tasks to specific projects using my AI agent?** You can just tell your agent what the task is and which project it belongs to. It will handle the placement automatically without you needing to open the app. **Can my AI agent read the comments on my Todoist tasks?** Yes, the Connector can pull discussion history from any specific task so you can stay caught up on team notes or feedback during your chat. **Can I see all my custom labels and tags with this?** Absolutely. Your agent can retrieve your full list of user-defined labels to help you categorize your work or filter your tasks on the fly. **Can I mark tasks as finished without opening the Todoist app?** Yes, you can simply tell your agent to complete a task by its name or ID, and it will update your Todoist status instantly. **Is the Todoist MCP good for managing team project tasks?** It's a great tool for team collaboration because it allows your agent to read comments, view project sections, and manage shared tasks across your projects. **Where do I get my Todoist API Token?** You can locate your personal API Token securely via the web application by clicking your profile avatar, going to **Settings**, and selecting the **Integrations** tab. Your token will be visible at the bottom or in a dedicated Developer section. Alternatively, navigate directly to `https://todoist.com/prefs/integrations`. **Can the agent delete projects or workspaces?** No. The integration exclusively lists resources (projects, items, labels) and supports only basic item modifications: creating tasks and marking tasks as completed. Destructive actions on structural settings are not supported. **Can the agent organize my tasks using sub-projects or sections?** Yes. The Todoist integration allows the agent to retrieve project IDs and navigate into their specific sections. When creating a new task, you can explicitly ask the agent to place it within a specific section to keep your work neatly organized. **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.