Todoist
Full implementation of Todoist Rest API for MCP server
https://todoist.run.tools
How to connect
-
Smithery (hosted)
1. Open https://smithery.ai/servers/todoist 2. Click Connect and complete OAuth in your MCP client (Claude, Cursor, VS Code, etc.) 3. MCP endpoint: https://todoist.run.tools
Tools (30)
-
TODOIST_ADD_WORKSPACETool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects. Generates UUID and temp_id automatically.
-
TODOIST_CLOSE_TASKThis tool marks an existing task as completed in Todoist. It requires the `task_id` of the task to be closed.
-
TODOIST_CREATE_COMMENTTool to create a new comment in Todoist. Use when you need to add a note to a specific task or project after confirming its ID.
-
TODOIST_CREATE_LABELCreates a new label.
-
TODOIST_CREATE_PROJECTCreates a new project in Todoist.
-
TODOIST_CREATE_SECTIONTool to create a new section within a specific project. Use when you need to group tasks under a new heading in a project.
-
TODOIST_CREATE_TASKCreate a new task in Todoist. This action allows users to create tasks with various parameters including content, due dates, priority, and more. The task can be created in a specific project, section, or as a subtask of another task.
-
TODOIST_DELETE_LABELTool to delete a specific label. Use when you need to permanently remove an unused label by its ID after confirming it's not in use. Example: "Delete label with ID 2298391482".
-
TODOIST_DELETE_PROJECTTool to delete a specific Todoist project. Use when you need to permanently remove a project by its ID.
-
TODOIST_DELETE_SECTIONTool to delete a specific section. Use when you need to permanently remove unused section by its ID after confirming it's not in use. Example: "Delete section with ID 82181370".
-
TODOIST_DELETE_TASKDelete a task from Todoist. This action permanently removes the task and all its subtasks.
-
TODOIST_GET_ALL_COMMENTSThis tool retrieves all comments associated with a specific task or project in Todoist. It requires either a task_id or a project_id to fetch the comments, and it returns a JSON array of comment objects with details such as id, posted_at, content, and attachment information.
-
TODOIST_GET_ALL_PROJECTSGet all projects from a user's Todoist account. This tool retrieves all projects from the authenticated user's Todoist account. The response includes details like project ID, name, color, parent project, sharing status, and other metadata for each project.
-
TODOIST_GET_ALL_SECTIONSTool to retrieve all the sections for a specific project in Todoist. Use when you need to list section structure within a project after selecting the project.
-
TODOIST_GET_ALL_TASKSFetches all INCOMPLETE tasks from Todoist and returns their details. IMPORTANT LIMITATIONS: - This endpoint only returns active (incomplete) tasks - Cannot retrieve completed tasks - use a different endpoint for that - Filter queries using 'completed', '!completed', or 'completed after' will fail - Project references must use existing project names or IDs Common use cases: - Get all tasks: no filter - Get today's tasks: filter="today" - Get overdue tasks: filter="overdue" - Get tasks from specif
-
TODOIST_GET_BACKUPSTool to list all available backup archives for the user. Use when you need to retrieve and review all existing backups.
-
TODOIST_GET_COMMENTTool to retrieve details of a specific comment by its comment_id. Use when you need full information (content, timestamp, or attachment) about a known comment.
-
TODOIST_GET_LABELTool to retrieve a specific label by its ID. Use when you need detailed info about a label after you have its ID.
-
TODOIST_GET_PROJECTTool to retrieve a specific project by its ID. Use when you have a project ID and need its metadata before display or update.
-
TODOIST_GET_SECTIONTool to retrieve a specific section by its ID. Use when you have a section ID and need its metadata before display or update.
-
TODOIST_GET_SPECIAL_BACKUPSTool to list special backup archives for the user. Use when you need to retrieve all project backups for the authenticated user after creating or managing projects.
-
TODOIST_GET_TASKTool to retrieve a specific task by its ID. Use when you need to fetch all details of an existing task before processing or display.
-
TODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTSTool to list all archived projects in a workspace. Use when you need to retrieve archived workspace projects with optional filters or pagination.
-
TODOIST_LIST_FILTERSTool to list all filters for the authenticated user. Use when you need to retrieve the current set of custom filters.
-
TODOIST_LIST_PENDING_WORKSPACE_INVITATIONSTool to list pending invitation emails in a workspace. Use when you need to check which email invites are still pending acceptance in a workspace.
-
TODOIST_REOPEN_TASKThis tool reopens previously completed task.
-
TODOIST_UPDATE_COMMENTTool to update a specific comment's content. Use when you need to correct or clarify an existing comment after confirming its ID and the new text.
-
TODOIST_UPDATE_PROJECTTool to update a specific project's attributes such as name, color, indent, and order. Use when you need to rename or reorder a project after reviewing its current settings. Example: "Update project 2203306141 name to 'Q1 Goals'."
-
TODOIST_UPDATE_SECTIONTool to update a specific section's attributes such as name and order. Use when you need to rename or reorder a section after confirming its ID.
-
TODOIST_UPDATE_TASKTool to update an existing task's properties. Use when you need to modify a task's details after confirming its ID and new values.