Skip to main content
Todoist logo
  • Category: task management
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 84
  • Triggers: 1
  • Slug: TODOIST
  • Version: 20261101_00

Tools

Slug: 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.

Input Parameters

string
Icon for the workspace (optional).
string
required
Name of the new workspace.
string
UUID for this command for idempotency. If omitted, a new UUID is generated.
integer
Color ID for the workspace (optional).
string
Temporary identifier to map the command to the created resource. If omitted, a new UUID is generated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_ARCHIVE_PROJECT2Tool to archive a project using Todoist API v1. For personal projects, archives it for the initiating user. For workspace projects, archives it for all workspace users.

Input Parameters

string
required
String ID of the project to archive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_BULK_CREATE_TASKSCreate multiple Todoist tasks in one Sync batch request. Individual commands can fail even when others succeed; inspect sync_status for each command’s result.

Input Parameters

array
required
Array of task specifications to create. Each task must have at minimum a ‘content’ field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CLOSE_TASKDEPRECATED: Use TODOIST_CLOSE_TASK_V1 instead. This tool marks an existing task as completed in Todoist. It requires the task_id of the task to be closed. Closing an already-completed task returns an error; check task state first if idempotent behavior is needed.

Input Parameters

string
required
The ID of the task to close (alphanumeric format from unified API v1). Verify the ID belongs to the intended task before calling, as completing the wrong task cannot be undone easily; use TODOIST_GET_ALL_TASKS or TODOIST_GET_TASK to confirm identity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CLOSE_TASK_V1Tool to close (complete) a task in Todoist using API v1. Use when you need to mark a task as complete using the v1 endpoint.

Input Parameters

string
required
String ID of the task to close. Regular tasks are marked complete and moved to history along with their subtasks. Tasks with recurring due dates are scheduled to their next occurrence.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CREATE_COMMENT_V1Tool to create a new comment on a project or task using Todoist API v1. Use when you need to add a note to a specific task or project. IMPORTANT: You must provide EXACTLY ONE of task_id or project_id - these parameters are mutually exclusive. - To comment on a task, provide task_id (and omit project_id) - To comment on a project, provide project_id (and omit task_id) - Providing both task_id AND project_id will cause an error.

Input Parameters

string
required
The content of the comment. Must be between 1 and 15000 characters.
string
The ID of the task to attach the comment to. IMPORTANT: Provide EITHER task_id OR project_id, but NOT BOTH. These parameters are mutually exclusive.
object
Attachment metadata for comments in API v1.
string
The ID of the project to attach the comment to. IMPORTANT: Provide EITHER project_id OR task_id, but NOT BOTH. These parameters are mutually exclusive.
array
Optional list of user IDs to notify about this comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CREATE_LABELDEPRECATED: Use TODOIST_CREATE_LABEL_V1 instead. Creates a new label.

Input Parameters

string
required
Name of the label. Must be a non-empty string.
integer ("30" | "31" | "32" | "33" | "34" | "35" | "36" | "37" | "38" | "39" | "40" | "41" | "42" | "43" | "44" | "45" | "46" | "47" | "48" | "49")
Color of the label. See https://developer.todoist.com/guides/#colors for available colors. Only supported integer codes from that reference are valid; arbitrary integers cause validation errors.
integer
The order of the label in the list.
boolean
Whether the label is a favorite.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CREATE_LABEL_V1Tool to create a new personal label using API v1. Use when you need to add a new label to organize tasks.

Input Parameters

string
required
Name of the new label. Must be between 1 and 128 characters.
string
Label color. Can be a color name (e.g., ‘blue’, ‘red’) or a color code (integer). Defaults to ‘charcoal’ if not specified.
integer
Position of the new label in the label list. Used by clients to sort labels.
boolean
Whether the label is marked as a favorite. Defaults to false if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CREATE_PROJECTCreates a new Todoist project. This action is deprecated; use the returned project ID for subsequent operations to avoid ambiguous name matches.

Input Parameters

string
required
Name of the project. Must be non-empty; empty values cause validation failures.
string ("berry_red" | "red" | "orange" | "yellow" | "olive_green" | "lime_green" | "green" | "mint_green" | "teal" | "sky_blue" | "light_blue" | "blue" | "grape" | "violet" | "lavender" | "magenta" | "salmon" | "charcoal" | "grey" | "taupe")
Enum for project colors. Names are based on Todoist’s standard palette.
boolean
Whether the project should be marked as a favorite.
string
ID of the parent project to create a sub-project. If not set, it’s a top-level project. Must reference an existing project ID; an incorrect value buries the project deep in the hierarchy.
string ("list" | "board")
Enum for project view styles.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CREATE_PROJECT2Tool to create a new project in Todoist using the unified API v1. Use when you need to create a new project with specific parameters like name, color, or parent project.

Input Parameters

string
required
The project name. This is the only required field.
string
Project color. Can be either a color name (e.g., ‘berry_red’, ‘blue’) or a numeric color code. Default is ‘charcoal’.
string
Parent project ID. If provided, creates this project as a sub-project. Can be either a string or integer ID.
string
View style of the project. Can be ‘list’ or ‘board’.
string
Description of the project. Optional field.
boolean
Whether the project is a favorite for the user. Default is false.
integer
Workspace ID. If provided, creates a workspace project instead of a personal project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CREATE_SECTIONDEPRECATED: Use TODOIST_CREATE_SECTION_V1 instead. Tool to create a new section within a specific project. Use when you need to group tasks under a new heading in a project.

Input Parameters

string
required
Name of the new section. This will be the section heading in the project.
integer
Position of the new section in the project. Lower values appear first. If not specified, the section will be added to the end.
string
required
ID of the project to add the section to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CREATE_SECTION_V1Tool to create a new section within a project using API v1. Use when you need to organize tasks under a new heading in a project.

Input Parameters

string
required
Name of the new section. This will be the section heading in the project.
integer
Position of the new section in the project. Lower values appear first. If not specified, the section will be added to the end.
string
required
ID of the project to add the section to. Must be a new-format alphanumeric string ID. Legacy numeric project IDs are not supported by the v1 API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_CREATE_TASKCreate a Todoist task with content, due dates, priority and other details in a project or section, or as a subtask. Project, section and parent task IDs consisting only of digits are rejected.

Input Parameters

integer
Non-zero integer value used to sort tasks under the same parent.
array
The task’s labels (list of names for personal/shared labels). Labels must already exist in Todoist; referencing non-existent labels may fail silently.
string
required
Task content/title. Can contain markdown-formatted text and hyperlinks. Do NOT include due dates or times in this field - use due_string instead.
string
Specific date in YYYY-MM-DD format relative to user’s timezone. Use this for exact dates without time. For natural language dates, use due_string instead. Only one due_* field can be used at a time (except due_lang). Cannot express recurrence; one-off tasks only. Use due_string (e.g., ‘every Friday’) for recurring schedules.
string
2-letter ISO 639-1 language code for parsing due_string. Required when due_string is in a language other than English. Supported codes: da (Danish), de (German), en (English), es (Spanish), fi (Finnish), fr (French), it (Italian), ja (Japanese), ko (Korean), nb (Norwegian), nl (Dutch), pl (Polish), pt (Portuguese), ru (Russian), sv (Swedish), tw (Traditional Chinese), zh (Chinese).
integer
Task duration amount as a positive integer. Must be used together with duration_unit. Use this field for task duration instead of embedding ‘for X minutes’ in due_string. Example: for a 15-minute task, set duration=15 and duration_unit=‘minute’.
integer
Task priority from 1 (normal) to 4 (urgent).
string
Parent task ID for creating subtasks. Use IDs from TODOIST_GET_ALL_TASKS or TODOIST_GET_ACTIVE_TASK.
string
Human-defined due date in arbitrary format. Accepts natural language expressions like ‘tomorrow’, ‘next Monday at 3pm’, ‘in 2 hours’, ‘every Friday’. Also accepts formatted dates like ‘Jan 21, 2026’ or ISO dates like ‘2026-01-21’. Value is interpreted using local time. IMPORTANT: If the due string is in a language other than English (e.g., ‘esta semana’ in Portuguese, ‘mañana’ in Spanish, ‘demain’ in French), you MUST also set the due_lang field with the appropriate 2-letter language code (e.g., ‘pt’ for Portuguese, ‘es’ for Spanish, ‘fr’ for French, ‘de’ for German), otherwise the API will reject it with ‘Invalid date format’. Do NOT include duration phrases like ‘for X minutes’ or ‘for X days’ in this field - use the separate duration and duration_unit fields instead. If duration is included, it will be automatically extracted and applied to the duration fields. Only one due_* field can be used at a time (except due_lang).
string
Project ID where the task will be created. Use IDs from TODOIST_GET_ALL_PROJECTS or TODOIST_CREATE_PROJECT. If not set, task is added to the user’s Inbox. Project names are not unique; always use numeric IDs.
string
Section ID to put task into. Use IDs from TODOIST_GET_ALL_SECTIONS.
string
The responsible user ID for shared tasks (numeric format).
string
Additional notes or details about the task. Can contain markdown-formatted text and hyperlinks. IMPORTANT: Do NOT include due dates, times, or scheduling information here - use the due_string field for natural language dates (e.g., ‘tomorrow at 2pm’) or due_date/due_datetime for specific dates.
string
Specific date and time in RFC3339 format in UTC. Use this for exact date and time. Only one due_* field can be used at a time (except due_lang). Cannot express recurrence; one-off tasks only. Use due_string for recurring schedules.
string ("minute" | "day")
Units for task duration in Todoist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_DELETE_COMMENTTool to delete a specific comment from Todoist by its ID. Use when you need to permanently remove a comment.

Input Parameters

string
required
The ID of the comment to delete. Todoist supports alphanumeric comment IDs (e.g., ‘6fvWm92qwCcwhq7W’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_DELETE_LABEL_V1Deletes a personal label by numeric ID using API v1. All instances of the label will be removed from tasks.

Input Parameters

string
required
The ID of the personal label to delete. All instances of the label will be removed from tasks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_DELETE_PROJECT2Tool to delete a project and all of its sections and tasks using Todoist API v1. Use when you need to permanently remove a project by its ID.

Input Parameters

string
required
The ID of the project to delete. Can be numeric or alphanumeric format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_DELETE_SECTION2Tool to delete a section and all tasks within it. Use when you need to permanently remove a section by its ID.

Input Parameters

string
required
ID of the section to delete. This will delete the section and all tasks within it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_DELETE_TASKTool to delete a specific task from Todoist. Permanently removes the task and all its subtasks with no recycle bin or undo option. Confirm with the user before executing, especially for bulk deletions.

Input Parameters

string
required
The ID of the task to delete. Todoist supports both numeric IDs (e.g., ‘2995104339’) and alphanumeric IDs (e.g., ‘6X4Vw2Hfmg73Q2XR’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_DELETE_TASK_V1DEPRECATED: Use TODOIST_DELETE_TASK instead. Tool to delete a specific task from Todoist using API v1. Use when you need to permanently remove a task by its ID.

Input Parameters

string
required
The ID of the task to delete. Todoist supports both numeric IDs (e.g., ‘2995104339’) and alphanumeric IDs (e.g., ‘6fvWm74vJ773g5p4’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_DELETE_UPLOADTool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded.

Input Parameters

string
required
The URL of the file to delete. This should be the full URL of the file as returned when it was uploaded (e.g., ‘https://files.todoist.com/…’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_EXPORT_TEMPLATE_AS_FILETool to export a Todoist project as a CSV template file. Use when you need to download a project template as a file for backup or sharing.

Input Parameters

string
required
The ID of the project to export as a template CSV file (alphanumeric V2 format, not numeric V1 IDs). Use TODOIST_GET_ALL_PROJECTS to get valid project IDs.
boolean
Whether to use relative dates in the template (e.g., ‘tomorrow’ instead of specific dates). Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_EXPORT_TEMPLATE_AS_URLTool to export a Todoist project as a shareable template URL. Use when you need to share a project structure or create copies from a template.

Input Parameters

string
required
The ID of the project to export as a template (alphanumeric V2 format, not numeric V1 IDs). Use TODOIST_GET_ALL_PROJECTS to get valid project IDs.
boolean
Whether to use relative dates in the template (e.g., ‘tomorrow’ instead of specific dates). Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_FILTER_TASKSTool to get all tasks matching the filter. Use when you need to retrieve tasks based on specific filter criteria. This is a paginated endpoint using cursor-based pagination.

Input Parameters

string
IETF language tag defining what language filter is written in, if differs from default English.
integer
The number of objects to return in a page (1-200). Default is 50.
string
required
Filter tasks using Todoist filter syntax. Terms must be valid keywords or reference existing entities in the user’s account. Comma operator (,) is NOT supported. CRITICAL: Multiple filter conditions MUST be joined with explicit logical operators (&, |, !). Space-separated filters are INVALID and will fail. Supported filters: predefined keywords (‘today’, ‘overdue’, ‘no due date’, ‘all’, etc.), priority (‘p1’-‘p4’), projects (‘#Name’), labels (‘@Name’), relative dates (‘7 days’, ‘-7 days’), date filters (‘due before: YYYY-MM-DD’, ‘due after: YYYY-MM-DD’), created/deadline (‘created after: -14 days’), search (‘search: keyword’). Operators: ’&’ (AND), ’|’ (OR), ’!’ (NOT).
string
Cursor for pagination. Provide the next_cursor value from previous response to get next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_ALL_COMMENTSRetrieve comments for a specific Todoist task or project, providing exactly one of task_id or project_id. Returns the first response page in the comments field; further pages cannot be requested with this tool.

Input Parameters

string
The ID of the task for which to retrieve comments. Mutually exclusive with project_id - provide only one, not both.
string
The ID of the project for which to retrieve comments. Mutually exclusive with task_id - provide only one, not both.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_ALL_PROJECTSGet a page of active projects from a user’s Todoist account. Returns projects with their id, name, color, parent, sharing status and inbox_project flag, plus a next cursor for pagination.

Input Parameters

integer
The number of projects to return per page. Defaults to server default if not provided.
string
Pagination cursor from a previous response. Use the next_cursor value to fetch the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_ALL_TASKSFetches all INCOMPLETE tasks from Todoist and returns their details. Supports cursor-based pagination. 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/label references must use ACTUAL EXISTING names from the user’s account - Arbitrary text in filters causes 400 errors - use ‘search: keyword’ for text search Common use cases: - Get all tasks: no filter - Get today’s tasks: filter=“today” - Get overdue tasks: filter=“overdue” - Get tasks from specific project: filter=“#ProjectName” (project must exist) - Get high priority tasks: filter=“p1” - Search task content: filter=“search: keyword” - Paginate results: use limit and cursor parameters

Input Parameters

array
List of task IDs to retrieve (alphanumeric string IDs).
string
Language code for parsing date/times in queries.
integer
The number of tasks to return per page. Default is 50.
string
Cursor for pagination. Provide the next_cursor value from previous response to get next page.
string
Filter tasks using Todoist filter syntax. This endpoint only returns INCOMPLETE tasks. Terms must be valid keywords or reference existing entities; arbitrary text causes 400 errors. Supported filters: predefined keywords (‘today’, ‘overdue’, ‘no due date’, etc.), priority (‘p1’-‘p4’), projects (‘#Name’), labels (‘@Name’), relative dates (‘7 days’, ‘-7 days’), date filters (‘due before: YYYY-MM-DD’), created/deadline (‘created after: -14 days’), search (‘search: keyword’). Operators: ’&’ (AND), ’|’ (OR), ’!’ (NOT). DO NOT USE: ‘completed’, ‘!completed’, ‘completed after’ - these cause 400 errors on this endpoint (use TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE instead).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_BACKUPSList available Todoist backup archives for the user, returning archive metadata rather than live task or project data. An empty list does not establish why backups are unavailable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_COMMENT_V1Tool to retrieve a single comment by ID using the v1 API. Use when you need to fetch details of a specific comment.

Input Parameters

string
required
String ID of the comment to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATETool to retrieve completed tasks within a specified completion date window. Use when you need to fetch historical completed tasks for reporting, audits, or weekly summaries. The API restricts the completion-date range to approximately 3 months between since and until parameters.

Input Parameters

integer
Maximum number of tasks to return per page. Optional parameter. API default is 50.
string
required
Start date for filtering completed tasks in RFC3339 format (e.g., ‘2024-01-01T00:00:00Z’). Must be before ‘until’. Maximum range between ‘since’ and ‘until’ is 3 months (~92 days).
string
required
End date for filtering completed tasks in RFC3339 format (e.g., ‘2024-01-31T23:59:59Z’). Must be after ‘since’. Maximum range between ‘since’ and ‘until’ is 3 months (~92 days).
string
Pagination cursor from previous response to fetch next page of results. Optional parameter.
string
Parent task ID in v2 alphanumeric format (e.g., ‘6fr9mHQJG3HV7gC4’) to filter completed subtasks. Use IDs from TODOIST_GET_ALL_TASKS. Numeric v1 IDs are deprecated.
string
Project ID in v2 alphanumeric format (e.g., ‘6fm7pCWp5Q3hhwHW’). Use IDs from TODOIST_GET_ALL_PROJECTS. Numeric v1 IDs are deprecated.
string
Section ID in v2 alphanumeric format (e.g., ‘6fm7pCWp5Q3hhwHW’). Use IDs from TODOIST_GET_ALL_SECTIONS. Numeric v1 IDs are deprecated.
string
Language code for parsing filter_query. Optional parameter.
string
Filter query string using Todoist’s filter syntax to further refine results. Optional parameter.
string
Workspace ID in v2 alphanumeric format (e.g., ‘6XvwwRvRfmCjM5PW’). Use IDs from TODOIST_GET_ALL_PROJECTS or similar actions. Numeric v1 IDs are deprecated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_ID_MAPPINGSTool to translate IDs between Todoist API v1 and v2. Use when you need to convert IDs between API versions for sections, tasks, comments, reminders, location_reminders, or projects.

Input Parameters

string
required
A comma-separated list of IDs to translate. When V1 IDs are provided, the function returns corresponding V2 IDs if they exist, and vice versa. Example: ‘6fmCXMqW3X96q47W,6fp4f67Gvc2qvjW4’
string ("sections" | "tasks" | "comments" | "reminders" | "location_reminders" | "projects")
required
The type of object to map. Must be one of: sections, tasks, comments, reminders, location_reminders, projects. IDs are not unique across object types.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_PERSONAL_LABELTool to retrieve a personal label by its ID. Use when you need to fetch details about a specific personal label.

Input Parameters

string
required
The ID of the personal label to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_PRODUCTIVITY_STATSTool to retrieve comprehensive productivity statistics for the authenticated user. Use when you need detailed completion data, karma scores, streaks, or goal tracking information for productivity reports and analysis.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_PROJECTTool to retrieve a specific project by its ID using Todoist API v1. Use when you have a project ID and need its metadata before display or update. Verify project_id matches the intended project before destructive operations — similar project names can cause mistakes; use TODOIST_GET_ALL_PROJECTS to resolve ambiguous names to IDs first.

Input Parameters

string
required
The ID of the project to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_PROJECT_FULLTool to retrieve full project data including all sections, tasks, and collaborators. Use when you need comprehensive project information beyond basic metadata.

Input Parameters

string
required
The ID of the project to retrieve (v2 format string ID required).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_PROJECT_PERMISSIONSTool to retrieve all available roles and their associated actions in Todoist projects. Use when you need to understand what permissions different roles have in projects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_SECTION_V1Tool to retrieve a specific section by its ID using Todoist v1 API. Use when you need section metadata from the v1 endpoint.

Input Parameters

string
Optional public key parameter for the request
string
required
String ID of the section

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_SPECIAL_BACKUPSList special backup archives for the authenticated user’s projects. An empty backup list can also indicate that the backup endpoint returned HTTP 404, so it does not by itself establish that no archives exist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_TASKRetrieve a specific Todoist task by ID for processing or display; this tool is deprecated. Comments and attachments with additional context require separate API calls.

Input Parameters

string
required
The ID of the task to retrieve. Source from a recent TODOIST_GET_ALL_TASKS call to avoid stale IDs. Use this tool to confirm task identity before destructive operations (delete, close).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_TASK2Tool to retrieve a single active (non-completed) task by ID using API v1. Use when you need to fetch task details from the v1 endpoint.

Input Parameters

string
required
String ID of the task to retrieve.
string
Optional public key for accessing shared tasks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_USERTool to retrieve information about the currently authenticated user. Use when you need user details like email, name, preferences, karma, or subscription status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_GET_WORKSPACE_PLAN_DETAILSTool to retrieve details about a workspace’s current plan and usage. Use when you need information about subscription status, member count, project limits, pricing, or trial status for a specific workspace.

Input Parameters

integer
required
ID of the workspace to retrieve plan details for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_IMPORT_TEMPLATE_INTO_PROJECT_BY_IDTool to import a template from Todoist’s template gallery into an existing project. Use when you need to add structured tasks and sections from a pre-made template to an existing project.

Input Parameters

string
Language locale for the template content. Defaults to ‘en’.
string
required
The ID of the existing project to import the template into (can be string or integer format). Use TODOIST_GET_ALL_PROJECTS to get valid project IDs.
string
required
The template identifier from Todoist’s template gallery (e.g., ‘project-tracker’, ‘gtd-weekly-review’, ‘meal-planning’). These IDs can be found by browsing todoist.com/templates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_IMPORT_TEMPLATE_INTO_PROJECT_FROM_FILETool to import a CSV template into an existing Todoist project from a file. Use when you need to bulk-create tasks, sections, and notes from a template file.

Input Parameters

object
required
The template file to upload and import. TYPE values must be lowercase: ‘task’, ‘section’, or ‘note’.
string
required
The ID of the project to import the template into. Can be either an alphanumeric V2 format (e.g., ‘6fvWmP68Wchcr6RJ’) or numeric V1 format. Use TODOIST_GET_ALL_PROJECTS to get valid project IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_INVITE_PROJECT_COLLABORATORTool to invite a collaborator to a Todoist project by email. Use when the user asks to share, invite someone to, or add a collaborator to a project. For workspace or team projects, you can optionally specify a role. If the role is omitted, the workspace default role is used. For invite-only workspace projects, the caller may need admin or owner permissions; otherwise the API may return a forbidden error.

Input Parameters

string
Role to assign to the collaborator in workspace/team projects. Only used for workspace projects. If omitted, the workspace default role will be applied. For personal projects, this parameter is ignored.
string
required
Email address of the person to invite as a collaborator.
string
required
ID of the project to share. Use TODOIST_GET_ALL_PROJECTS or TODOIST_GET_PROJECT to retrieve valid project IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_ACTIVITIESTool to get activity logs from Todoist. Returns a paginated list of activity events for the user. Events can be filtered by object type (project, item, note), event type, and other criteria. Uses cursor-based pagination for efficient navigation through results.

Input Parameters

integer
Maximum number of activity logs to return per page.
string
Pagination cursor for fetching the next page of results. Use the value returned in the next_cursor field from a previous response.
string
Filter activities to only those that occurred before this date (exclusive upper bound). Must be in ISO 8601 format (e.g. ‘2026-02-01T00:00:00Z’). When specified, overrides the default pagination behavior and allows custom date ranges.
string
Filter activities to only those that occurred on or after this date. Must be in ISO 8601 format (e.g. ‘2026-01-01T00:00:00Z’). When specified, overrides the default pagination behavior and allows custom date ranges.
string
The ID of the specific object to get activities for. Must be used together with object_type. For example, to get activities for a specific task, set object_type=item and object_id=<task_id>.
string
Filter by a simple event type (e.g., “added”, “deleted”, “completed”). Returns events of this type across ALL object types that support it. For more precise filtering by both object type and event type, use object_event_types instead.
string ("project" | "item" | "note")
The type of object to filter activities by. Must be one of “project”, “item” (task), or “note” (comment). When specified with object_id, returns activities for that specific object.
string
Filter activities to only those initiated by the specified user ID(s). Accepts either a single user ID or a list of user IDs. Useful for shared projects to see who made which changes.
string
Filter activities to only those belonging to the specified workspace(s). Accepts either a single workspace ID or a list of workspace IDs.
boolean
When true, includes additional information about comments in the extra_data field, such as the content of the comment.
string
Filter activities to only those belonging to the specified task. Returns activities for the task itself and all its comments.
boolean
When true, includes additional information about parent objects in the extra_data field, such as the name of the parent project or task.
boolean
Deprecated - This parameter has no implementation and will be removed in a future version.
string
Filter by whether the activity has an initiator. When true, returns only activities with no initiator (your own activities). When false, returns only activities initiated by collaborators.
string
Filter activities to only those belonging to the specified project. Returns activities for the project itself and all its tasks and comments.
string
Advanced filtering for specific object type and event type combinations. Format: [“object_type:event_type”]. Examples: [“item:deleted”] for deleted tasks, [“item:”] for all task events, [“:deleted”] for all delete events across all types, [“item:deleted”, “note:added”] for multiple filters. Valid event types: “added”, “deleted”, “updated”, “completed”, “uncompleted”, “archived”, “unarchived”, “shared”, “left”, “reordered”, “moved”. This is the recommended way to filter events.
boolean
When true and object_id is specified, also include activities for all child objects. For example, when filtering by a project, also include activities for all its tasks and comments.
boolean
When true and object_id is specified, also include activities for the parent object. For example, when filtering by a specific task, also include activities for its parent project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_ALL_INVITATIONS_WORKSPACESTool to return a list containing details of all pending invitations to a workspace. Use when you need to view all pending workspace invitations. This list is not paginated, and all workspace members can access it.

Input Parameters

integer
required
ID of the workspace to list invitations for. This parameter is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_ARCHIVED_PROJECTSTool to get all archived projects from Todoist. Use when you need to retrieve archived projects with pagination support.

Input Parameters

integer
The number of projects to return in a single page. Defaults to 50 if not specified.
string
Pagination cursor for fetching the next page of results. Use the ‘next_cursor’ from the previous response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_ARCHIVED_SECTIONSRetrieve archived sections for a specific Todoist project. The response may indicate that more results are available.

Input Parameters

string
required
The ID of the project to get archived sections from. This must be a v1 project ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTSTool to list all archived projects in a workspace. Archived projects are excluded from TODOIST_GET_ALL_PROJECTS; combine both tools when a complete project list is needed. Use when you need to retrieve archived workspace projects with optional filters or pagination.

Input Parameters

integer
Limit the number of returned projects.
string
Return archived projects updated after this datetime (ISO 8601).
string
Return archived projects updated before this datetime (ISO 8601).
integer
Offset for pagination.
array
List of project IDs to filter the results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_COMPLETED_TASKSTool to retrieve all completed tasks with optional project filtering. Use when you need to fetch completed tasks without date range restrictions. Note: This action uses an undocumented Todoist API endpoint (/api/v1/tasks/completed). The endpoint is not officially documented but is confirmed to work based on runtime testing. The response schemas are based on actual API responses.

Input Parameters

integer
Maximum number of tasks to return per page. Optional parameter.
string
Pagination cursor from previous response to fetch next page of results. Optional parameter.
string
Filter completed tasks by project ID. Optional parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_COMPLETED_TASKS_BY_DUE_DATETool to retrieve completed tasks within a specified due date range (up to 6 weeks). Use when you need to fetch completed tasks filtered by their original due dates rather than completion dates.

Input Parameters

integer
Maximum number of tasks to return per page. Optional parameter. API default is 50.
string
required
Start date for filtering completed tasks by due date in YYYY-MM-DD format. Must be before ‘until’. Maximum range between ‘since’ and ‘until’ is 6 weeks (42 days).
string
required
End date for filtering completed tasks by due date in YYYY-MM-DD format. Must be after ‘since’. Maximum range between ‘since’ and ‘until’ is 6 weeks (42 days).
string
Pagination cursor from previous response to fetch next page of results. Optional parameter.
string
Filter tasks by parent task ID to get completed subtasks of a specific parent. Optional parameter.
string
Filter tasks by project ID to get completed tasks within a specific project. Optional parameter.
string
Filter tasks by section ID to get completed tasks within a specific section. Optional parameter.
string
Language code for parsing filter_query. Optional parameter.
string
Filter query string using Todoist’s filter syntax to further refine results. Supports many Todoist filters like priority (p1-p4), labels (@labelname), and search queries. Optional parameter.
string
Filter tasks by workspace ID to get all completed tasks from projects the user has joined in that workspace. Optional parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_FILTERSTool to list all filters for the authenticated user. Use when you need to retrieve the current set of custom filters.

Input Parameters

string
Token for incremental sync. Use ’*’ for full sync.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_JOINABLE_WORKSPACESTool to get workspaces the user can join. Use when you need to discover available workspaces that the authenticated user can join.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_LABELSTool to get all user labels with pagination support. Use when you need to retrieve labels from the user’s Todoist account.

Input Parameters

integer
The number of objects to return in a page. Default is 50.
string
Cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_PENDING_WORKSPACE_INVITATIONSList pending invitations for a Todoist workspace to check which email invites are awaiting acceptance. An empty list does not necessarily mean there are no pending invitations; it can also indicate that the workspace was not found or that invitation data was absent from the response.

Input Parameters

string
required
ID of the workspace to list pending invitations for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_PROJECT_COLLABORATORSTool to get all collaborators for a given project with cursor-based pagination. Use when you need to retrieve the list of people who have access to a specific project.

Input Parameters

integer
The number of objects to return in a page. Default is 50 if not specified.
string
Pagination cursor to fetch the next page of results. Obtained from previous response’s next_cursor field.
string
required
String ID of the project
string
Public key for accessing public projects

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_SECTIONSTool to get all active sections for the user, with optional filtering by project. Supports cursor-based pagination to handle large result sets.

Input Parameters

integer
The number of objects to return in a page. Default is 50.
string
Pagination cursor for fetching the next page of results. Use the next_cursor value from a previous response.
string
String ID of the project to get sections from. If omitted or null, get sections from all projects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_SHARED_LABELSTool to retrieve shared label names from active tasks with pagination support. Use when you need to list labels across the workspace with optional filtering of personal labels.

Input Parameters

integer
The number of label names to return in a single page. Defaults to 50 if not specified.
string
Pagination cursor from a previous response. Use to fetch the next page of results.
boolean
If true, excludes personal labels from the results and returns only shared workspace labels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_WORKSPACE_ACTIVE_PROJECTSList a page of active projects in a workspace, including visible projects not yet joined, with cursor pagination. Guests see only joined projects and must supply a workspace ID.

Input Parameters

integer
Maximum number of projects to return per request. Defaults to 100 if not specified.
string
Pagination cursor for fetching the next page of results.
string
ID of the workspace to list active projects for. If omitted, the action auto-resolves to the user’s workspace when they belong to exactly one. Users in multiple workspaces must pass an explicit workspace_id; an error listing the candidates is returned otherwise. Workspaces are a Todoist Business/Teams feature; personal/free accounts have none.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_WORKSPACE_ARCHIVED_PROJECTSTool to get archived projects in a workspace. Use when you need to retrieve a list of archived projects for a specific workspace with optional pagination.

Input Parameters

integer
Maximum number of projects to return per page. Defaults to 100 if not specified. Optional query parameter.
string
Cursor for pagination to fetch the next page of results. Optional query parameter.
string
The workspace ID to retrieve archived projects from. If omitted, the action auto-resolves to the user’s workspace when they belong to exactly one. Users in multiple workspaces must pass an explicit workspace_id; an error listing the candidates is returned otherwise. Workspaces are a Todoist Business/Teams feature; personal/free accounts have none.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_WORKSPACE_INVITATIONSTool to list user emails with pending invitations to a workspace. Use when you need to check which email invites are still pending. The list is not paginated and accessible by all workspace members.

Input Parameters

integer
required
ID of the workspace to list pending invitations for. All workspace members can access this list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_LIST_WORKSPACE_USERSTool to list users in workspace(s). Use when you need to retrieve workspace members. Returns users from a specific workspace if workspace_id is provided, otherwise returns users from all workspaces the authenticated user is part of. Not accessible by guests.

Input Parameters

integer
Maximum number of workspace users to return per request. Default is 100.
string
Pagination cursor for retrieving the next set of results. Use the next_cursor value from a previous response.
string
ID of the workspace to list users for. If not provided, returns users from all workspaces the authenticated user is part of.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_MOVE_TASKMove a task to another project, section, or parent task using a Sync API command. A success result can be returned without explicit confirmation that the command succeeded.

Input Parameters

string
required
The ID of the task to move.
string
Parent task ID to move the task under (re-parent as subtask). Mutually exclusive with project_id and section_id - only one can be provided.
string
Project ID to move the task to. Mutually exclusive with section_id and parent_id - only one can be provided.
string
Section ID to move the task to. Mutually exclusive with project_id and parent_id - only one can be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_MOVE_TASK_REST_APITool to move a task to another project, section, or parent task using the REST API. Use when you need to relocate a task while preserving its identity and metadata.

Input Parameters

string
required
ID of the task to move. Must be in Todoist API v1 format (base32-encoded alphanumeric string).
string
ID of the parent task to move the task under. Must be in Todoist API v1 format (base32-encoded alphanumeric string). At least one of project_id, section_id, or parent_id is required.
string
ID of the project to move the task to. Must be in Todoist API v1 format (base32-encoded alphanumeric string). At least one of project_id, section_id, or parent_id is required.
string
ID of the section to move the task to. Must be in Todoist API v1 format (base32-encoded alphanumeric string). At least one of project_id, section_id, or parent_id is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_QUICK_ADD_TASKTool to add tasks using natural language parsing similar to the official Todoist clients. Use when you want to create a task quickly with natural language that includes dates, projects, labels, priority, and other task attributes in a single text string.

Input Parameters

boolean
When enabled, returns additional metadata about the parsing. Defaults to False.
string
Additional note or description for the task. This is separate from the task text.
string
required
Natural language task text that will be parsed. Can include: due date in free form text (e.g., ‘tomorrow’, ‘next Monday at 3pm’), project name starting with ’#’ (e.g., ‘#ProjectName’), label starting with ’@’ (e.g., ‘@urgent’), assignee starting with ’+’ (e.g., ‘+john@example.com’), priority (e.g., ‘p1’, ‘p2’, ‘p3’, ‘p4’), deadline between ’{}’ (e.g., ‘{in 3 days}’), or description starting from ’//’ until the end of the text (e.g., ’// additional notes’). Example: ‘Buy milk tomorrow at 5pm #Shopping @groceries p1’
string
Reminder date in free form text. Examples: ‘in 30 minutes’, ‘tomorrow at 9am’, ‘1 hour before’.
boolean
When enabled, a default reminder will be added to the task if it has a due date with time set. Defaults to False.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_REMOVE_SHARED_LABEL_V1Tool to remove a shared label from all active tasks using API v1. Use when you need to remove a shared label created by a collaborator from your account.

Input Parameters

string
required
The name of the shared label to remove from all active tasks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_RENAME_SHARED_LABELS_V1Tool to rename a shared label across all active tasks using API v1. Use when you need to change the name of a shared label.

Input Parameters

string
required
The current name of the shared label to rename.
string
required
The new name for the shared label.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_REOPEN_TASK2Tool to reopen a completed task in Todoist using API v1. Use when you need to restore a previously completed task. Any ancestor tasks or sections will also be marked as uncomplete and restored from history.

Input Parameters

string
required
The ID of the task to reopen. Todoist supports both numeric IDs (e.g., ‘2995104339’) and alphanumeric IDs (e.g., ‘6fmCXPVrjPvHggWW’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_REORDER_TASKSReorder tasks in bulk by submitting their child_order positions through the Sync API item_reorder command. Check the returned sync_status for the command result, which may indicate an error.

Input Parameters

array
required
Array of task IDs with their new child_order positions. Each task will be assigned the specified order among its siblings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_SEARCH_LABELSTool to search user labels by name with case-insensitive matching. Use when you need to find specific labels by name pattern.

Input Parameters

integer
The number of objects to return in a page. Defaults to 50 if not specified.
string
required
Search query to match label names. Matching is case-insensitive. Queries are matched literally unless * (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash.
string
Cursor for pagination. Use the next_cursor value from a previous response to fetch the next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_SEARCH_PROJECTSSearch active user projects by name with support for wildcards and pagination. Use when you need to find projects matching a specific name pattern.

Input Parameters

integer
The number of projects to return per page. If not specified, defaults to 50. Maximum value may be limited by the API.
string
required
Search query to match project names. Matching is case-insensitive. Queries are matched literally unless * (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash. Example: '' matches all projects, ‘Work’ matches projects starting with ‘Work’.
string
Pagination cursor for fetching the next page of results. Provide the ‘next_cursor’ value from a previous response to get the next page. Leave empty for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_SEARCH_SECTIONSTool to search active sections by name, optionally filtered by project. Use when you need to find sections matching a specific name pattern across all projects or within a specific project. Supports pagination for large result sets.

Input Parameters

integer
The number of objects to return in a page. Default is 50.
string
required
Search query to match section names. Matching is case-insensitive. Queries are matched literally unless * (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash.
string
Cursor for pagination. Use the next_cursor value from a previous response to fetch the next page.
string
String ID of the project to search sections from. If omitted or null, search sections from all projects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_SYNCTool to sync data with Todoist server, supporting both read and write operations. This is the central endpoint used by Todoist apps for all data synchronization. Use this action to: - Read multiple resource types in a single request (projects, tasks, labels, etc.) - Perform batch write operations (create/update/delete up to 100 resources at once) - Implement efficient incremental sync using sync tokens - Execute complex multi-step operations in a single atomic request For read-only operations, pass sync_token and resource_types. For write operations, include commands array with the operations to execute. Commands support batching up to 100 operations per request.

Input Parameters

array
Array of write commands to execute. Supports batching up to 100 commands. Each command modifies resources (add/update/delete). Commands are executed sequentially. Use temp_id in commands to reference newly created resources within the same batch. Common command types: item_add, item_update, item_delete, item_complete, item_uncomplete, item_move, project_add, project_update, project_delete, section_add, label_add, filter_add, reminder_add.
string
required
Synchronization token marking the point in time of the last sync. Use ’*’ for full sync (retrieves all active data). For incremental sync, use the sync_token returned from the previous sync response. This enables efficient delta updates.
array
Array of resource types to retrieve. Use [‘all’] to fetch all resources. Specific types: ‘projects’, ‘items’, ‘sections’, ‘labels’, ‘filters’, ‘reminders’, ‘notes’, ‘collaborators’, ‘user’, ‘live_notifications’, ‘user_settings’, etc. Only returned resources will be included in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UNARCHIVE_PROJECT2Tool to unarchive a previously archived Todoist project using API v1. Use when you need to reactivate an archived project, making it visible again for the initiating user (personal projects) or all workspace users (workspace projects).

Input Parameters

string
required
The ID of the project to unarchive. Must be a valid project ID string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_COMMENT2Tool to update a comment by ID and return its content via v1 API. Use when you need to modify an existing comment’s text using the v1 API endpoint.

Input Parameters

string
required
New content for the comment. If null or an empty string, no update is performed.
string
required
String ID of the comment to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_LABEL_V1_SECONDTool to update an existing label using API v1. Use when you need to modify a label’s name, color, order, or favorite status.

Input Parameters

string
Updated label name. Must be between 1 and 128 characters if provided. Passing null or omitting this field will leave it unchanged.
string
Label color. Can be a color name (e.g., ‘blue’, ‘red’) or a color code (integer). Passing null or omitting this field will leave it unchanged.
integer
Position of the label in the label list. Used by clients to sort labels. Passing null or omitting this field will leave it unchanged.
string
required
The ID of the label to update.
boolean
Whether the label is marked as a favorite. Passing null or omitting this field will leave it unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_NOTIFICATION_SETTINGTool to update notification settings for the current user. Use when you need to enable or disable notifications for specific event types and channels.

Input Parameters

string
Optional token parameter for push notifications.
string ("email" | "push")
required
The communication channel for this notification. Must be either ‘email’ or ‘push’.
boolean
required
Whether to disable notifications for this type and service. Set to true to turn off notifications, false to enable them.
string ("note_added" | "item_assigned" | "item_completed" | "item_uncompleted" | "karma_level" | "share_invitation_sent" | "share_invitation_accepted" | "share_invitation_rejected" | "share_invitation_blocked_by_project_limit" | "user_left_project" | "user_removed_from_project" | "teams_workspace_upgraded" | "teams_workspace_canceled" | "teams_workspace_payment_failed" | "pro_trial_started" | "pro_trial_ended" | "workspace_invitation_created" | "workspace_invitation_accepted" | "workspace_invitation_rejected" | "project_archived" | "project_moved" | "removed_from_workspace" | "workspace_deleted" | "message" | "workspace_user_joined_by_domain" | "price_increase_new_pro_users" | "price_increase_new_team" | "price_increase_new_team_trial" | "price_increase_android" | "workspace_team_cohort_tagged")
required
The type of notification being configured. Must be one of the predefined notification types.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_PROJECTDEPRECATED: Use TODOIST_TODOIST_UPDATE_PROJECT2 instead. Tool to update a project’s properties including name, color, favorite status, and view style. Use when you need to modify project settings after reviewing its current configuration.

Input Parameters

string
New name for the project. At least one of name, color, is_favorite, or view_style must be provided.
string ("berry_red" | "red" | "orange" | "yellow" | "olive_green" | "lime_green" | "green" | "mint_green" | "teal" | "sky_blue" | "light_blue" | "blue" | "grape" | "violet" | "lavender" | "magenta" | "salmon" | "charcoal" | "grey" | "taupe")
Enum for project colors. Names are based on Todoist’s standard palette.
string
required
The ID of the project to update.
string ("list" | "board")
Enum for project view styles.
boolean
Whether the project should be marked as a favorite. At least one of name, color, is_favorite, or view_style must be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_PROJECT2Tool to update a project’s properties using Todoist API v1. Use when you need to modify project settings like name, description, favorite status, color, or view style.

Input Parameters

string
Updated project name. Passing null or omitting this field will leave it unchanged.
string
Updated project color. Passing null or omitting this field will leave it unchanged.
string
required
String ID of the project to update (v1 format).
string
Updated project view style (e.g., ‘list’ or ‘board’). Passing null or omitting this field will leave it unchanged.
string
Updated project description. Passing null or omitting this field will leave it unchanged.
boolean
Whether the project is marked as a favorite. Passing null or omitting this field will leave it unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_SECTIONDEPRECATED: Use TODOIST_TODOIST_UPDATE_SECTION2 instead. Tool to update a specific section’s name. Use when you need to rename a section after confirming its ID.

Input Parameters

string
New name for the section. Omit or pass null to leave unchanged.
string
required
The ID of the section to update. This should be a numeric string from the ‘id’ field of section objects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_SECTION2Tool to update an existing section by its ID using Todoist v1 API. Use when you need to rename a section.

Input Parameters

string
Updated section name. Passing null or omitting this field will leave it unchanged.
string
required
String ID of the section to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_TASKTool to update an existing task’s properties. Cannot change a task’s project; to move a task, use TODOIST_CREATE_TASK then TODOIST_DELETE_TASK. Use when you need to modify a task’s details after confirming its ID and new values.

Input Parameters

array
List of label names to assign to the task. Replaces the entire existing labels list — omit a label only if intentionally removing it. Labels must already exist in Todoist; non-existent names fail silently.
string
New content for the task.
string
required
The ID of the task to update.
string
Due date in YYYY-MM-DD format.
string
Language code for parsing due_string, e.g., ‘en’.
integer
Positive integer for task duration amount (how long the task takes). Must be used together with duration_unit. This is separate from due date - use due_string/due_date/due_datetime for when the task is due.
integer
Task priority from 1 (normal) to 4 (urgent).
string
Human-readable due date string for natural language date parsing. Examples: ‘tomorrow’, ‘next Monday’, ‘Jan 15 at 3pm’, ‘in 2 days’. Duration syntax like ‘for X minutes’ is automatically extracted and converted to the duration/duration_unit fields. Provide exactly one of due_string, due_date, or due_datetime per call — supplying multiple may cause silent failures. To clear an existing due date, pass ‘no date’.
string
User ID to assign the task to.
string
New description for the task.
string
Due date and time in RFC3339 format.
string
Deadline date in YYYY-MM-DD format (premium feature).
string ("minute" | "day")
Units for task duration in Todoist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPDATE_WORKSPACE_LOGOTool to upload an image as the workspace logo or delete the existing logo. Use when you need to set or remove a workspace’s branding image.

Input Parameters

object
Image file to upload as workspace logo. Required when delete is false or not provided. Supported formats: PNG, JPEG, JPG.
boolean
If set to true, removes the workspace logo completely. When true, the file parameter is not required.
integer
required
The ID of the workspace to update the logo for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TODOIST_UPLOAD_FILETool to upload a file to Todoist. Use when you need to attach files to tasks or projects. The uploaded file can be later attached to comments or tasks using the returned file_url.

Input Parameters

object
required
File to upload to Todoist.
string
The ID of the project to associate the uploaded file with. If not provided, the file will be uploaded without project association.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: TODOIST_NEW_TASK_CREATEDType: pollTrigger when a new task is added to Todoist.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
(Optional) Filter new tasks by project ID.

Payload

string
Type of event
object
required
The Todoist task object