- Category: task management
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 84
- Triggers: 1
- Slug:
TODOIST - Version: 20261101_00
Tools
Add Workspace
Add Workspace
Archive Project (API v1)
Archive Project (API v1)
Bulk Create Tasks
Bulk Create Tasks
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
Output
Close Task (Deprecated)
Close Task (Deprecated)
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
Output
Close Task (API v1)
Close Task (API v1)
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
Output
Create Comment (API v1)
Create Comment (API v1)
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
Output
Create Label (Deprecated)
Create Label (Deprecated)
TODOIST_CREATE_LABELDEPRECATED: Use TODOIST_CREATE_LABEL_V1 instead. Creates a new label.Input Parameters
Output
Create Label (API v1)
Create Label (API v1)
Create Project (Deprecated)
Create Project (Deprecated)
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
Output
Create Project (API v1)
Create Project (API v1)
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
Output
Create Section (Deprecated)
Create Section (Deprecated)
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
Output
Create Section (API v1)
Create Section (API v1)
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
Output
Create task
Create task
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
Output
Delete Comment
Delete Comment
Delete Label (V1)
Delete Label (V1)
Delete Project (API v1)
Delete Project (API v1)
Delete Section (v1)
Delete Section (v1)
Delete Task
Delete Task
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
Output
Delete Task (API v1)
Delete Task (API v1)
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
Output
Delete Upload
Delete Upload
TODOIST_DELETE_UPLOADTool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded.Input Parameters
Output
Export Template As File
Export Template As File
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
Output
Export Template As URL
Export Template As URL
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
Output
Filter Tasks
Filter Tasks
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
Output
Get All Comments
Get All Comments
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
Output
Get all projects
Get all projects
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
Output
Get All Tasks
Get All Tasks
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 parametersInput Parameters
Output
Get Backups
Get Backups
Get Comment (V1)
Get Comment (V1)
Get Completed Tasks By Completion Date
Get Completed Tasks By Completion Date
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
Output
Get ID Mappings
Get ID Mappings
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
Output
Get Personal Label
Get Personal Label
Get Productivity Stats
Get Productivity Stats
Get Project (API v1)
Get Project (API v1)
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
Output
Get Full Project Data
Get Full Project Data
Get Project Permissions
Get Project Permissions
Get Section (v1 API)
Get Section (v1 API)
Get Special Backups
Get Special Backups
Get Task (Deprecated)
Get Task (Deprecated)
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
Output
Get Task (API v1)
Get Task (API v1)
Get User
Get User
Get Workspace Plan Details
Get Workspace Plan Details
Import Template Into Project By ID
Import Template Into Project By ID
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
Output
Import Template Into Project From File
Import Template Into Project From File
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
Output
Invite Project Collaborator
Invite Project Collaborator
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
Output
List Activities
List Activities
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
Output
List All Workspace Invitations
List All Workspace Invitations
List Archived Projects
List Archived Projects
List Archived Sections
List Archived Sections
List Archived Workspace Projects
List Archived Workspace Projects
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
Output
List Completed Tasks
List Completed Tasks
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
Output
List Completed Tasks By Due Date
List Completed Tasks By Due Date
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
Output
List Filters
List Filters
List Joinable Workspaces
List Joinable Workspaces
List Labels
List Labels
List Pending Workspace Invitations
List Pending Workspace Invitations
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
Output
List Project Collaborators
List Project Collaborators
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
Output
List Sections
List Sections
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
Output
List Workspace Active Projects
List Workspace Active Projects
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
Output
List Workspace Archived Projects
List Workspace Archived Projects
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
Output
List Workspace Invitations
List Workspace Invitations
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
Output
List Workspace Users
List Workspace Users
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
Output
Move Task
Move Task
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
Output
Move Task (REST API)
Move Task (REST API)
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
Output
Quick Add Task
Quick Add Task
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
Output
Reopen Task (API v1)
Reopen Task (API v1)
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
Output
Reorder Tasks
Reorder Tasks
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
Output
Search Labels
Search Labels
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
* (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash.Output
Search Projects
Search Projects
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
* (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash. Example: '' matches all projects, ‘Work’ matches projects starting with ‘Work’.Output
Search Sections
Search Sections
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
* (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash.Output
Todoist Sync
Todoist Sync
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
Output
Unarchive Project (API v1)
Unarchive Project (API v1)
Update Comment (v1)
Update Comment (v1)
Update Label (API v1)
Update Label (API v1)
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
Output
Update Notification Setting
Update Notification Setting
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
Output
Update Project (Deprecated)
Update Project (Deprecated)
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
Output
Update Project (API v1)
Update Project (API v1)
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
Output
Update Section (Deprecated)
Update Section (Deprecated)
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
Output
Update Section (v1)
Update Section (v1)
Update Task
Update Task
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
Output
Update Workspace Logo
Update Workspace Logo
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
Output
Upload File
Upload File
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.