Skip to main content
Todoist MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 47
  • Triggers: 0
  • Slug: TODOIST_MCP
  • Version: 20261018_00

Tools

Slug: TODOIST_MCP_ADD_COMMENTSAdd multiple comments to tasks or projects, optionally notifying collaborators. Each comment must specify either taskId or projectId.

Input Parameters

array
required
The array of comments to add.

Output

array
required
The created comments.
number
required
The total number of comments created.
array
required
The IDs of the added comments.
Slug: TODOIST_MCP_ADD_FILTERSAdd one or more new personal filters. Filters are saved custom views using query syntax to organize tasks.

Input Parameters

array
required
The array of filters to add.

Output

array
required
The created filters.
number
required
The total number of filters created.
Slug: TODOIST_MCP_ADD_LABELSAdd one or more new personal labels.

Input Parameters

array
required
The array of labels to add.

Output

array
required
The created labels.
number
required
The total number of labels created.
Slug: TODOIST_MCP_ADD_PROJECTSAdd one or more new projects.

Input Parameters

array
required
The array of projects to add.

Output

array
required
Projects that could not be created, with the reason for each. A failure here does not affect the other projects in the batch — do not retry the whole batch; address or drop the failed items.
array
required
The created projects.
number
required
The total number of projects created.
number
required
The number of failed project creations.
number
required
The number of successfully created projects.
number
required
The total number of projects requested.
Slug: TODOIST_MCP_ADD_REMINDERSAdd reminders to tasks. Supports three types: “relative” (minutes before due), “absolute” (specific date/time), or “location” (geofence-triggered). Each reminder must specify a taskId.

Input Parameters

array
required
Array of reminders to create (max 25). Each reminder must specify a type: “relative” (minutes before due), “absolute” (specific date/time), or “location” (geofence trigger).

Output

array
required
The created reminders.
number
required
Total number of reminders created.
array
required
IDs of the created reminders.
Slug: TODOIST_MCP_ADD_SECTIONSAdd one or more new sections to projects.

Input Parameters

array
required
The array of sections to add.

Output

array
required
Sections that could not be created, with the reason for each. A failure here does not affect the other sections in the batch — do not retry the whole batch; address or drop the failed items.
array
required
The created sections.
number
required
The total number of sections created.
number
required
The number of failed section creations.
number
required
The number of successfully created sections.
number
required
The total number of sections requested.
Slug: TODOIST_MCP_ADD_TASKSAdd one or more tasks to a project, section, or parent. Supports assignment to project collaborators.

Input Parameters

array
required
The array of tasks to add (max 25).

Output

array
required
The created tasks.
array
required
Failed task creations with error details.
number
required
The total number of tasks created.
number
required
The number of failed task creations.
number
required
The number of successfully created tasks.
number
required
The total number of tasks requested.
Slug: TODOIST_MCP_ANALYZE_PROJECT_HEALTHTrigger a new health analysis for a project. Use this when the health data is stale or you want a fresh assessment. The analysis may take time to complete — use get-project-health afterward to see updated results.

Input Parameters

string
required
The ID of the project to analyze. This triggers a new health analysis which may take some time to complete.

Output

object
required
The health response returned after triggering analysis.
string
required
A human-readable message about the analysis status.
string
required
The project ID.
Slug: TODOIST_MCP_COMPLETE_TASKSComplete one or more tasks by their IDs.

Input Parameters

array
required
The IDs of the tasks to complete.

Output

array
required
Failed task completions with error details.
array
required
The IDs of successfully completed tasks.
number
required
The number of failed task completions.
number
required
The number of successfully completed tasks.
number
required
The total number of tasks requested to complete.
Slug: TODOIST_MCP_DELETE_OBJECTDelete a project, section, task, comment, label, filter, reminder, or location_reminder by its ID. Projects can be deleted whether active or archived (find archived ones via find-projects with archivedStatus); note a workspace project must be archived before it can be deleted, while personal projects can be deleted regardless.

Input Parameters

string
required
The ID of the entity to delete.
string ("project" | "section" | "task" | "comment" | "label" | "filter" | "reminder" | "location_reminder")
required
The type of entity to delete.

Output

boolean
required
Whether the deletion was successful.
object
required
Information about the deleted entity.
Slug: TODOIST_MCP_EXPORT_PROJECT_TEMPLATEExport an existing project as a Todoist template, either as CSV content or as a shareable URL. Use it to duplicate a project, share its structure, or hand the CSV to import-project-template. To read a project rather than export it, use find-tasks instead — it returns structured tasks rather than raw CSV. Nothing is modified.

Input Parameters

string ("file" | "url")
How to return the template. “file” returns the CSV content, which can be passed straight back to import-project-template. “url” returns a shareable download link instead, and is the better choice for large projects because it does not return the whole file.
string
required
The ID of the project to export as a template.
boolean
Export due dates relative to the import date (e.g. “day 3”) instead of absolute dates. Defaults to false.

Output

string ("file" | "url")
required
The format the template was exported in.
string
The template as CSV content. Only present when format is “file”.
string
The shareable download URL. Only present when format is “url”.
string
The generated template file name. Only present when format is “url”.
number
Number of rows in the exported CSV. Only present when format is “file”.
Slug: TODOIST_MCP_FETCHFetch the full contents of a task or project by its ID. The ID should be in the format “task:{id}” or “project:{id}”.

Input Parameters

string
required
A unique identifier for the document in the format “task:{id}” or “project:{id}”.

Output

string
required
The ID of the fetched document.
string
required
The URL of the document.
string
required
The text content of the document.
string
required
The title of the document.
object
Additional metadata about the document.
Slug: TODOIST_MCP_FETCH_OBJECTFetch a single task, project, comment, or section by its ID. Use this when you have a specific object ID and want to retrieve its full details. Set includeChildren to also get its direct subtasks or sub-projects.

Input Parameters

string
required
The unique ID of the object to fetch.
string ("task" | "project" | "comment" | "section")
required
The type of object to fetch.
boolean
Also return the direct children of the object: subtasks for a task, sub-projects for a project. Returns childCount plus a compact list, flagging each child that has children of its own. Use this to check whether a task hides subtasks instead of a speculative find-tasks lookup. Ignored for comments and sections.

Output

string
required
The ID of the fetched object.
string ("task" | "project" | "comment" | "section")
required
The type of object fetched.
string
required
The fetched object data.
array
Direct children only: subtasks for a task, sub-projects for a project. Completed subtasks and archived sub-projects are excluded.
number
The number of direct children listed in children. Only present when children were requested and the type supports them. 0 means the object definitively has none.
string
Present when the children lookup failed or returned incomplete information. When no children are listed alongside it, childCount is unknown - do not read its absence as “no children”.
boolean
Present when the object has more than 25 direct children and the list was truncated. Page through the rest with find-tasks by parentId for subtasks, or find-projects for sub-projects.
Slug: TODOIST_MCP_FIND_ACTIVITYRetrieve activity logs to monitor and audit changes in Todoist. Shows events from all users by default (use initiatorId to filter by specific user). To answer what someone completed in a period, including recurring task occurrences, use objectType “task”, eventType “completed”, and dateFrom/dateTo. For a first-person question (“what did I get done”), also set initiatorId to the current user from user-info, or the answer includes collaborators’ completions. Track task completions, updates, deletions, project changes, and more with flexible filtering. Activity history availability and retention depend on the user plan.

Input Parameters

integer
Maximum number of activity events to return.
string
Pagination cursor for retrieving the next page of results.
string
Exclusive end of the activity range, as an ISO 8601 date or date-time. For all events on 2026-08-02, use “2026-08-03T00:00:00-04:00”. Natural-language dates such as “tomorrow” are not supported.
string
Filter events by parent task ID (for subtask events).
string
Inclusive start of the activity range, as an ISO 8601 date or date-time. For all events on one local calendar day, use that day’s start, for example “2026-08-02T00:00:00-04:00”. Natural-language dates such as “tomorrow” are not supported.
string
Filter by specific object ID (task, project, or comment).
string ("added" | "updated" | "deleted" | "completed" | "uncompleted" | "archived" | "unarchived" | "shared" | "left")
Type of event to filter by.
string
Filter events by parent project ID.
string ("task" | "project" | "comment")
Type of object to filter by.
string
Filter by the user ID who initiated the event. A first-person question (“what did I complete”) needs this: without it the results cover every collaborator. Get the ID from user-info when you do not already have it.

Output

array
required
The activity events.
boolean
required
string
number
required
The total number of events in this page.
object
required
Slug: TODOIST_MCP_FIND_COMMENTSFind comments by task, project, or get a specific comment by ID. Exactly one of taskId, projectId, or commentId must be provided.

Input Parameters

integer
Maximum number of comments to return
string
Pagination cursor for retrieving more results.
string
Find comments for a specific task.
string
Get a specific comment by ID.
string
Find comments for a specific project. Project ID should be an ID string, or the text “inbox”, for inbox tasks.

Output

boolean
required
array
required
The found comments.
string
required
The ID that was searched for (comment, task, or project ID).
string
string
required
The type of search performed: “single” (comment ID), “task” (task ID), or “project” (project ID).
number
required
The total number of comments in this page.
Slug: TODOIST_MCP_FIND_COMPLETED_TASKSGet completed tasks in a date range. For “what did I complete/get done” questions, use find-activity instead — it reports completion events, including every occurrence of a recurring task, which this tool does not. since/until are optional and default to a 7-day window when omitted. Includes all collaborators by default. Person-specific queries (summaries, plans, reports) require responsibleUser.

Input Parameters

string ("completion" | "due")
The method to use to get the tasks: “completion” to get tasks by completion date (ie, when the task was actually completed), “due” to get tasks by due date (ie, when the task was due to be completed by).
integer
The maximum number of tasks to return.
string
Optional start date for completed tasks. Format: YYYY-MM-DD. Defaults to 6 days before until (or today if until is omitted), resulting in a 7-day window.
string
Optional end date for completed tasks. Format: YYYY-MM-DD. Defaults to 6 days after since (or today if since is omitted), resulting in a 7-day window.
string
The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).
array
The labels to filter the tasks by
string
The ID of the parent task to get the tasks for.
string
The ID of the project to get the tasks for. Project ID should be an ID string, or the text “inbox”, for inbox tasks.
string
The ID of the section to get the tasks for.
string
The ID of the workspace to get the tasks for.
string ("and" | "or")
The operator to use when filtering by labels. This will dictate whether a task has all labels, or some of them. Default is “or”.
string
Filter completed tasks assigned to this user. User ID, name, or email. For personal queries (summaries, plans, reports), set to current user from user-info to exclude collaborators. Defaults to all collaborators.

Output

array
required
The found completed tasks.
boolean
required
string
number
required
The total number of tasks in this page.
object
required
Slug: TODOIST_MCP_FIND_FILTERSList all personal filters or search for filters by name. Filters are saved custom views that use query syntax to organize tasks (e.g. “today & p1”, “#Work & overdue”).

Input Parameters

Search for a filter by name (partial and case insensitive match). If omitted, all filters are returned.

Output

array
required
The found filters.
number
required
The total number of filters returned.
Slug: TODOIST_MCP_FIND_LABELSList personal labels and shared labels. Personal labels have full metadata (id, name, color, order, isFavorite) and support pagination and name search (partial, case insensitive). Shared labels are labels used on tasks shared with you — they are returned as names only (no IDs or metadata). When searching, all matching personal labels are fetched across all pages and returned as a single result set (limit and cursor are ignored). When not searching, personal labels are returned with pagination.

Input Parameters

integer
The maximum number of labels to return.
string
The cursor to get the next page of labels (cursor is obtained from the previous call to this tool, with the same parameters). Ignored when searchText is provided.
string
Search for a label by name (partial and case insensitive match). Supports wildcards (e.g. “work*” for prefix match). Use ”*” for a literal asterisk. If omitted, all labels are returned.

Output

array
required
The found personal labels.
boolean
required
string
number
required
The total number of labels in this page.
array
required
Names of all shared labels visible to you. These have no IDs or metadata — use their names directly when filtering tasks.
object
required
Slug: TODOIST_MCP_FIND_PROJECT_COLLABORATORSFind Todoist users (collaborators, teammates) by name or email to look up their user ID. Use this whenever the user asks to find, look up, or identify a person — e.g. “find Carrie’s user ID”, “who is Ernesto”, “look up a user”. When projectId is omitted, searches across the collaborators of every shared project the authenticated user has access to, plus the authenticated user themselves — an empty result means the person is not a collaborator on any project you share with them, not necessarily that they do not exist in Todoist. When projectId is provided, searches only that project. Partial, case-insensitive match on name and email.

Input Parameters

string
Optional. If provided, searches only collaborators of this project. If omitted, searches across the collaborators of all shared projects the authenticated user can access (plus the authenticated user themselves) — use this for general “find a user” / “who is X” lookups.
string
Search for a user by name or email (partial and case insensitive match). If omitted, all users are returned.

Output

number
required
The total number of users found.
object
Information about the project (only present when projectId was provided).
array
required
The found users.
object
required
number
The total number of available users before the search filter was applied.
Slug: TODOIST_MCP_FIND_PROJECTSList all projects or search for projects by name. By default only active projects are returned; use archivedStatus (‘archived’ or ‘all’) to include archived projects. When searching or when archivedStatus is ‘all’, all matching projects are returned (pagination is ignored). Otherwise projects are returned with pagination.

Input Parameters

integer
The maximum number of projects to return.
string
The cursor to get the next page of projects (cursor is obtained from the previous call to this tool, with the same parameters).
string
Search for a project by name (partial and case insensitive match). Supports wildcards (e.g. “work*” for prefix match). Use ”*” for a literal asterisk. If omitted, all projects are returned.
string ("active" | "archived" | "all")
Which projects to return by archive status: ‘active’ (default, non-archived only), ‘archived’ (archived only), or ‘all’ (both active and archived). Each project includes an isArchived field. Archived projects can be deleted via the delete-object tool (type: ‘project’).

Output

boolean
required
array
required
The found projects.
string
number
required
The total number of projects in this page.
object
required
Slug: TODOIST_MCP_FIND_REMINDERSFind reminders by task ID (returns all reminder types), or get a specific reminder by its ID. Use reminderId for time-based reminders and locationReminderId for location reminders.

Input Parameters

string
Find all reminders for a specific task. Returns both time-based and location reminders.
string
Get a specific time-based reminder (relative or absolute) by its ID.
string
Get a specific location reminder by its ID.

Output

string
required
The ID used for the search.
array
required
The found reminders (time-based and location).
string
required
The search type used: “task”, “reminder”, or “location_reminder”.
number
required
Total reminders in this response.
Slug: TODOIST_MCP_FIND_SECTIONSSearch for sections by name or other criteria in a project. When searching, uses server-side search to avoid fetching all sections.

Input Parameters

string
required
The ID of the project to search sections in. Project ID should be an ID string, or the text “inbox”, for inbox tasks.
string
Search for a section by name (partial and case insensitive match). Supports wildcards (e.g. “work*” for prefix match). Use ”*” for a literal asterisk. If omitted, all sections in the project are returned.

Output

array
required
The found sections.
number
required
The total number of sections found.
object
required
Slug: TODOIST_MCP_FIND_TASKSFind tasks by text search, project/section/parent container, responsible user, labels, a raw Todoist filter string, or a saved filter by ID or name (filterIdOrName). At least one filter must be provided.

Input Parameters

integer
The maximum number of tasks to return.
string
The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).
string
A raw Todoist filter query string (e.g. “today”, “p1”, “##Work”, “(today | overdue) & p1”). Combined with other filters using AND. Cannot be used with projectId, sectionId, parentId, or filterIdOrName.
array
The labels to filter the tasks by
string
Find subtasks of this parent task.
string
Find tasks in this project. Project ID should be an ID string, or the text “inbox”, for inbox tasks.
string
Find tasks in this section.
string
The text to search for in tasks.
string
The ID or name of a saved Todoist filter. The filter’s query will be fetched and used to find tasks. Cannot be used with the filter parameter, projectId, sectionId, or parentId.
string ("and" | "or")
The operator to use when filtering by labels. This will dictate whether a task has all labels, or some of them. Default is “or”.
string
Find tasks assigned to this user. Can be a user ID, name, or email address. The current user also includes unassigned tasks.
string ("assigned" | "unassignedOrMe" | "all")
How to filter by responsible user when responsibleUser is not provided. “assigned” = only tasks assigned to others; “unassignedOrMe” = only unassigned tasks or tasks assigned to me; “all” = all tasks regardless of assignment. Default value will be unassignedOrMe.

Output

array
required
The found tasks.
boolean
required
string
number
required
The total number of tasks in this page.
object
required
Slug: TODOIST_MCP_FIND_TASKS_BY_DATEGet tasks by date range. startDate=‘today’ includes overdue items. Default responsibleUserFiltering=‘unassignedOrMe’ excludes others’ tasks.

Input Parameters

integer
The maximum number of tasks to return. Default is 10.
string
The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters).
array
The labels to filter the tasks by
integer
The number of days to get the tasks for, starting from the start date. Default is 1 which means only tasks for the start date.
string
The start date to get the tasks for. Format: YYYY-MM-DD, or ‘today’, which by default also includes overdue tasks.
string ("overdue-only" | "include-overdue" | "exclude-overdue")
How to handle overdue tasks. ‘overdue-only’ to get only overdue tasks, ‘include-overdue’ to include overdue tasks along with tasks for the specified date(s), and ‘exclude-overdue’ to exclude overdue tasks. Default is ‘include-overdue’.
string ("and" | "or")
The operator to use when filtering by labels. This will dictate whether a task has all labels, or some of them. Default is “or”.
string
Filter tasks assigned to this user. User ID, name, or email. The current user also includes unassigned tasks.
string ("assigned" | "unassignedOrMe" | "all")
Filter when responsibleUser is omitted. ‘assigned’=assigned to others; ‘unassignedOrMe’=unassigned+mine; ‘all’=everyone. Default: ‘unassignedOrMe’.

Output

array
required
The found tasks.
boolean
required
string
number
required
The total number of tasks in this page.
object
required
Slug: TODOIST_MCP_GET_OVERVIEWGet a Markdown overview. If no projectId is provided, shows all projects with hierarchy and sections (useful for navigation). If projectId is provided, shows detailed overview of that specific project including all tasks grouped by sections.

Input Parameters

string
Optional project ID. If provided, shows detailed overview of that project. If omitted, shows overview of all projects.

Output

string ("account_overview" | "project_overview")
required
The type of overview returned.
object
Inbox information (account overview only).
object
Statistics object (project overview only).
array
List of tasks (project overview only).
object
Project details (project overview only).
array
List of projects with hierarchy, folders, and ordering (account overview only).
array
List of sections (project overview only).
number
Total number of tasks.
object
Project information (project overview only).
number
Total number of projects (account overview only).
number
Total number of sections (project overview only).
boolean
Whether account has nested projects (account overview only).
number
Number of tasks not in any section (project overview only).
Slug: TODOIST_MCP_GET_PRODUCTIVITY_STATSGet comprehensive productivity statistics including daily/weekly completion breakdowns, goal streaks (current, last, max), karma score and trends, and historical karma data. Useful for productivity analysis and tracking goal progress. Reports counts, streaks and karma only, never the tasks themselves — for “what did I complete”, use find-activity.

Output

object
required
Goal and streak information.
number
required
Current karma score.
array
required
Daily completion breakdown (most recent days).
array
required
Weekly completion breakdown (most recent weeks).
string
required
Karma trend direction (e.g., “up” or “down”).
object
required
Map of project ID to color key.
number
required
Total number of completed tasks (all-time).
array
required
Historical karma data points for graphing.
number
required
Timestamp of the last karma update.
array
required
Recent karma change events with reasons.
Slug: TODOIST_MCP_GET_PROJECT_ACTIVITY_STATSGet daily and optional weekly task completion counts for a project over a configurable time window (1-12 weeks). Useful for identifying completion trends and patterns.

Input Parameters

integer
Number of weeks of activity data to retrieve (1-12, default 2).
string
required
The ID of the project to get activity stats for.
boolean
Include weekly rollup counts alongside daily counts.

Output

array
required
Daily task completion counts.
string
required
The project ID.
array
Weekly completion rollups. Only included when includeWeeklyCounts is true.
Slug: TODOIST_MCP_GET_PROJECT_HEALTHGet a comprehensive health assessment for a project including completion progress, health status (EXCELLENT, ON_TRACK, AT_RISK, CRITICAL), and optional detailed context with project metrics and task-level data. Use includeContext=true for that full detail.

Input Parameters

string
required
The ID of the project to check health for.
boolean
Include detailed health context with project metrics and task-level data. May produce large output for projects with many tasks.

Output

object
required
Project health assessment.
object
Detailed project context with metrics and task data. Only included when includeContext is true.
object
required
Project completion progress.
string
required
The project ID.
string
required
The project name.
Slug: TODOIST_MCP_GET_WORKSPACE_INSIGHTSGet aggregated health and progress insights across all projects in a workspace. Accepts workspace name or ID, with optional project ID filtering. Useful for a cross-project health overview.

Input Parameters

array
Optional list of project IDs to scope insights to specific projects.
string
required
The workspace ID or name. Supports exact ID, exact name match (case-insensitive), or unique partial name match.

Output

string
required
The resolved workspace ID.
string
required
The resolved workspace name.
array
required
Health and progress insights for each project in the workspace.
Slug: TODOIST_MCP_IMPORT_PROJECT_TEMPLATEImport a template into an existing project, adding its tasks, sections and comments to whatever is already there. Source it by template ID/URL or by passing CSV content from export-project-template. To start a new project from a template, create the project with add-projects first, then import into it. This writes immediately and cannot be undone, so only run it against a project the user named.

Input Parameters

string
Locale for the imported content when using templateId. Defaults to “en”.
string
required
The ID of the existing project to import the template into.
string
The template to import — either a gallery slug (“product-launch”), a personal template ID (“UT_28Ex…”), or a full Todoist template URL, which is reduced to the ID automatically. Gallery templates work for anyone; personal templates only for the account that owns them. There is no way to list templates through this server, so only use the ID or URL the user supplied. Provide either this or csvFileContent, not both.
string
Raw CSV template content, as produced by export-project-template. Provide either this or templateId, not both.

Output

array
required
Tasks created by the import.
array
required
Comments created by the import.
array
required
Sections created by the import.
number
required
The total number of objects created by the import.
Slug: TODOIST_MCP_LIST_WORKSPACESGet all workspaces for the authenticated user. Returns workspace details including ID, name, plan type (STARTER/BUSINESS), user role (ADMIN/MEMBER/GUEST), link sharing settings, guest permissions, creation date, and creator ID.

Output

string
required
The type of the response.
number
required
The total number of workspaces.
array
required
List of workspaces.
Slug: TODOIST_MCP_MANAGE_ASSIGNMENTSBulk assignment operations for multiple tasks. Supports assign, unassign, and reassign operations with atomic rollback on failures.

Input Parameters

boolean
If true, validates operations without executing them.
array
required
The IDs of the tasks to operate on (max 50).
string ("assign" | "unassign" | "reassign")
required
The assignment operation to perform.
string
The user to assign tasks to. Can be “me” (assigns to current user), a user ID, name, or email. Required for assign and reassign operations.
string
For reassign operations: the current assignee to reassign from. Can be user ID, name, or email. Optional - if not provided, reassigns from any current assignee.

Output

array
required
Results of the assignment operations.
object
Summary of the operation.
Slug: TODOIST_MCP_PROJECT_MANAGEMENTArchive or unarchive a project by its ID.

Input Parameters

string ("archive" | "unarchive")
required
The action to perform on the project.
string
required
The ID of the project.

Output

object
required
The updated project.
boolean
required
Whether the action was successful.
Slug: TODOIST_MCP_PROJECT_MOVEMove a project between personal and workspace contexts.

Input Parameters

string ("move-to-workspace" | "move-to-personal")
required
The action to perform on the project.
string
Optional target folder ID within the workspace.
string
required
The ID of the project to move.
string ("restricted" | "team" | "public")
Optional access visibility for the project in the workspace (restricted, team, or public).
string
The target workspace ID. Required when action is move-to-workspace.

Output

object
required
The moved project.
boolean
required
Whether the move was successful.
Slug: TODOIST_MCP_REORDER_OBJECTSReorder sibling projects or sections, and optionally move projects to a new parent. For projects: set order to reorder siblings, and/or set parentId to move under a new parent (use “root” for top level). For sections: set order to reorder within a project.

Input Parameters

string ("project" | "section")
required
The type of entity to reorder. “project” reorders sibling projects within the same parent (and can move projects to a new parent). “section” reorders sections within the same project.
array
required
The items to reorder or move. Each item must have at least order or parentId. Items with parentId will be moved first, then items with order will be reordered. All items being reordered should be siblings for predictable results.

Output

string ("project" | "section")
required
The type of entity that was reordered/moved.
boolean
required
Whether the operation was successful.
number
required
The number of entities moved to a new parent.
array
required
The IDs of all affected entities.
number
required
The number of entities reordered.
Slug: TODOIST_MCP_RESCHEDULE_TASKSReschedule tasks to new dates while preserving recurring schedules. Unlike update-tasks (which replaces the entire due string and can wipe recurrence), this tool changes only the date, keeping recurrence patterns intact. Use this when moving recurring tasks to a different date without altering their repeat pattern.

Input Parameters

array
required
The tasks to reschedule with their new dates.

Output

array
required
The rescheduled tasks.
number
required
The total number of tasks rescheduled.
array
required
The IDs of the rescheduled tasks.
Slug: TODOIST_MCP_SEARCHSearch across tasks and projects in Todoist. Returns a list of relevant results with IDs, titles, and URLs.

Input Parameters

string
required
The search query string to find tasks and projects.

Output

array
required
The search results.
number
required
Total number of results found.
Slug: TODOIST_MCP_UNCOMPLETE_TASKSUncomplete (reopen) one or more completed tasks by their IDs.

Input Parameters

array
required
The IDs of the tasks to uncomplete.

Output

array
required
Failed task uncompletion with error details.
array
required
The IDs of successfully uncompleted tasks.
number
required
The number of failed task uncompletions.
number
required
The number of successfully uncompleted tasks.
number
required
The total number of tasks requested to uncomplete.
Slug: TODOIST_MCP_UPDATE_COMMENTSUpdate multiple existing comments with new content.

Input Parameters

array
required
The comments to update.

Output

array
required
The updated comments.
number
required
The total number of comments updated.
object
required
Summary of operations performed.
array
required
The IDs of the updated comments.
Slug: TODOIST_MCP_UPDATE_FILTERSUpdate one or more existing personal filters with new values.

Input Parameters

array
required
The filters to update.

Output

array
required
The updated filters.
number
required
The total number of filters updated.
array
required
The IDs of the updated filters.
object
required
Summary of operations performed.
Slug: TODOIST_MCP_UPDATE_LABELSUpdate one or more existing labels. Personal labels (identified by ID) can have their name, color, order, and favorite flag updated. Shared labels (identified by name) can only be renamed.

Input Parameters

array
required
The labels to update. Use labelType=“personal” with an ID to update a personal label, or labelType=“shared” with name+newName to rename a shared label.

Output

number
required
The total number of successful operations (personal + shared).
array
required
The updated personal labels.
object
required
Summary of operations performed.
array
required
The shared labels that were renamed.
Slug: TODOIST_MCP_UPDATE_PROJECTSUpdate multiple existing projects with new values.

Input Parameters

array
required
The projects to update.

Output

array
required
Projects that could not be updated, with the reason for each. A failure here does not affect the other projects in the batch — do not retry the whole batch; address or drop the failed items.
array
required
The updated projects.
number
required
The total number of projects updated.
object
required
Summary of operations performed.
array
required
The IDs of the updated projects.
Slug: TODOIST_MCP_UPDATE_REMINDERSUpdate existing reminders. Each reminder must specify its type (“relative”, “absolute”, or “location”) and ID. Only include fields that need to change.

Input Parameters

array
required
Array of reminders to update (max 25). Each must include the reminder type and ID. Only include fields that need to change.

Output

array
required
The updated reminders.
number
required
Total reminders updated.
array
required
IDs of updated reminders.
Slug: TODOIST_MCP_UPDATE_SECTIONSUpdate multiple existing sections with new values.

Input Parameters

array
required
The sections to update.

Output

array
required
The updated sections.
number
required
The total number of sections updated.
array
required
The IDs of the updated sections.
Slug: TODOIST_MCP_UPDATE_TASKSUpdate existing tasks including content, dates, priorities, and assignments. Send only the fields that change.

Input Parameters

array
required
The tasks to update (max 25).

Output

array
required
The updated tasks.
array
required
Tasks that could not be updated, with the reason for each. A failure here does not affect the other tasks in the batch.
number
required
The total number of tasks updated.
array
required
The IDs of the updated tasks.
object
required
Summary of operations performed.
Slug: TODOIST_MCP_USER_INFOGet comprehensive user information including user ID, full name, email, timezone with current local time, week start day preferences, current week dates, daily/weekly goal progress, and user plan (Free/Pro/Business).

Output

string ("Todoist Free" | "Todoist Pro" | "Todoist Business")
required
The user plan.
string
required
The type of the response.
string
required
The email address of the user.
string
required
The user ID.
string
required
The full name of the user.
number
required
The start day of the week (1 = Monday, 7 = Sunday).
string
required
The timezone of the user.
number
required
The daily goal for task completions.
number
required
The weekly goal for task completions.
string
required
The end date of the current week (YYYY-MM-DD).
string
required
The name of the start day.
string
required
The start date of the current week (YYYY-MM-DD).
number
required
The number of tasks completed today.
string
required
The current local time of the user.
number
required
The current week number of the year.
Slug: TODOIST_MCP_VIEW_ATTACHMENTView a file attachment from a Todoist comment. Pass the fileUrl from a comment’s fileAttachment field. Supports images (returned inline), text files (returned as text), and binary files like PDFs (returned as embedded resources).

Input Parameters

string
required
The URL of the attachment file to view. Get this from the fileUrl field in a comment’s fileAttachment.