# Todoist MCP > Todoist MCP Server connects your Todoist account directly to any AI client. You can view active tasks, manage projects, create new items, and check discussion history—all without ever having to open the native app. It lets you keep complex project data inside your chat window. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-management, to-do-list, personal-productivity, task-tracking, workflow-automation, reminders ## Description You connect **Todoist** straight to your agent, and you keep all your damn project work right inside this chat window. You don't gotta open the whole Todoist app; we handle it here. It lets you manage projects, check off tasks, and track down discussion history using plain commands. ### Project Organization You can start by seeing every single active folder in your entire workspace with `list_projects`. That gives you a rundown of all the major project areas you're working on. Once you pick a specific project, you can drill down and view exactly what sections are inside it using `list_sections`. This shows you how everything is organized within that one project. ### Managing Your Tasks The core function here is task control. You can pull up all your pending items by running `list_tasks`, and you'll even get the option to filter those tasks down to a single, specific project ID if you know what you're looking for. If you spot something that needs to be finished, just run `complete_task` on it; the agent marks that task as done immediately in Todoist. Need to add something? You can create brand new items using `create_task`. You tell the agent what the task is, and you decide if it belongs in a specific project or if it's just floating in your general inbox. It handles the placement for ya. ### Context and Details If you need context on an old assignment, you can retrieve all discussion history associated with any given item using `list_comments`. This pulls up every comment made on that task so you don't lose track of what was decided. You can also get a full inventory of your work categories by running `list_labels`, which shows you every user-defined tag or label you've set up in Todoist. ## Tools ### complete_task Marks an existing task as finished in Todoist. ### create_task Adds a brand new item to your task list, specifying content and optionally a project ID. ### list_comments Retrieves all comments associated with a specific task. ### list_labels Shows every user-defined label or tag you have set up in your account. ### list_projects Retrieves a list of all currently active project folders. ### list_sections Lists the specific organizational sections inside one given project. ### list_tasks Shows your pending tasks, with an option to filter them by a project ID. ## Prompt Examples **Prompt:** ``` Check all my active tasks and projects. ``` **Response:** ``` I've retrieved 3 projects (Personal, Work, Grocery). Under your Inbox, you have 1 active task: - Task: 'Summarize weekly sync', ID: 81229 ``` **Prompt:** ``` Complete the task with ID 81229. ``` **Response:** ``` I have successfully marked the task 81229 as completed in your Todoist workspace. ``` ## Capabilities ### List Projects Retrieves a list of every active project folder in your Todoist workspace. ### View Project Sections Lists all sections contained within a specific, designated project. ### List Tasks Retrieves a list of active tasks, with the option to filter by a specific project ID. ### Create Task Adds a new task item to a chosen project or your general inbox using plain conversational input. ### Mark Task Complete Changes the status of an existing, pending task to completed immediately. ### List Comments Retrieves all discussion history and comments associated with a specific task. ### Check Labels/Tags Provides a full list of user-defined labels available for categorizing your work. ## Use Cases ### The Weekly Check-in A PM needs an immediate status report for a client meeting. Instead of opening the app and clicking through five different projects, they ask their agent to run `list_projects` first, then loop through them using `list_tasks`. The agent gathers all pending items into one conversational summary. ### Catching Up on a Feature A developer jumps back into a bug fix they started last week. They need to know what decisions were made. Rather than digging through emails, they ask the agent about the task and use `list_comments` to see the full discussion history instantly. ### Adding an Off-the-Cuff Idea A quick thought pops up during a meeting. The user doesn't want to open Todoist, so they instruct their agent to run `create_task` for 'Follow up on Q3 budget' and assign it to the 'Finance' project using plain text. ### Cleanup After Deployment The team just finished a big push. A developer asks the agent to check off all the small, completed coding chores by running `complete_task` for several IDs, clearing their backlog in one go. ## Benefits - **Instant Status Checks:** Need to know what's pending? Use `list_tasks` or `list_projects` to pull a full overview of your workload without switching tabs. You get the list immediately in your conversation window. - **Zero Context Switching:** Don't open Todoist. Just tell your agent, 'What are my tasks for Project X?' The agent runs `list_tasks` and gives you the answer instantly. No app required. - **Maintain Discussion History:** When a task gets complicated, use `list_comments`. You can pull up every discussion point on an old item without having to click through pages of chat logs. - **Quick Task Closure:** Finished working on that chore? Use `complete_task` with the ID. It instantly marks it done in Todoist—no manual clicking needed. - **Structured Project View:** You can get a bird's eye view by first running `list_projects`, then narrowing down to specific sections using `list_sections`. This lets you map out your entire project structure quickly. ## How It Works The bottom line is, once the token is set up, your AI client handles all the complex calls to keep your tasks organized in chat. 1. Subscribe to the Todoist MCP Server on Vinkius. 2. Go to your Todoist integrations page and generate a personal API Token. 3. Input that token into your agent's setup. Now you can run task-management queries naturally. ## Frequently Asked Questions **How do I list all active projects using Todoist MCP Server?** You run `list_projects`. This tool fetches every project folder that is currently set up in your account, giving you a clean list of available scopes. **Can I check task comments with Todoist MCP Server?** Yes. Use the `list_comments` tool and provide the specific task ID. It retrieves the entire discussion history for that single item, so you don't have to dig through emails. **How do I add a new task in Todoist MCP Server?** Use `create_task`. You just need to provide the content of the task and an optional project ID. The agent handles writing it into your todo list for you. **What is the difference between listing tasks and listing projects with Todoist MCP Server?** `list_projects` gives you the top-level containers (the folders). `list_tasks` only shows the actual items inside those containers, usually requiring a project ID to filter correctly. **What steps are needed to authenticate with Todoist MCP Server?** You must generate a personal API Token from your Todoist account's integration page. This token authorizes your AI client to execute commands like `list_tasks` and `complete_task` within your workspace. **Can the Todoist MCP Server filter my active tasks using specific IDs or projects?** Yes, you can use the `list_tasks` tool by providing a specific project ID. This filters out irrelevant data instantly, giving you a focused list of only the items relevant to that single project. **Does the Todoist MCP Server have rate limits or handle API errors?** The server follows standard Todoist API rate limits. If your agent exceeds them, it receives an explicit error message telling you exactly when and why the command failed, preventing data loss. **How does using `list_labels` help me manage task organization?** Running `list_labels` shows all your existing user-defined tags. You can then use these labels to categorize and group tasks across different projects, providing a high-level view of your work structure. **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.