New Task Created
Trigger when a new task is added to Todoist.
TriggerpollTry it
Integrate Todoist
with your AI workspace
Todoist is a task management tool allowing users to create to-do lists, set deadlines, and collaborate on projects with reminders and cross-platform syncing
Explore Triggers and Actions
Add Workspace
Tool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects. Generates UUID and temp_id automatically.
ActionTry it
Archive Project (API v1)
Tool 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.
ActionTry it
Bulk Create Tasks
Create many tasks in one request using Todoist's Sync batching. Use when scaffolding projects or creating multiple tasks at once to reduce round trips.
ActionTry it
Close Task (API v1)
Tool to close (complete) a task in Todoist using API v1. Use when you need to mark a task as complete using the v1 endpoint.
ActionTry it
Close Task (Deprecated)
DEPRECATED: 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.
ActionTry it
Create Comment (API v1)
Tool 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.
ActionTry it
Create Label (API v1)
Tool to create a new personal label using API v1. Use when you need to add a new label to organize tasks.
ActionTry it
Create Label (Deprecated)
DEPRECATED: Use TODOIST_CREATE_LABEL_V1 instead. Creates a new label.
ActionTry it
Create Project (API v1)
Tool 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.
ActionTry it
Create Project (Deprecated)
DEPRECATED: Use TODOIST_TODOIST_CREATE_PROJECT2 instead. Creates a new project in Todoist. Project names are not unique; use the returned project_id for subsequent operations to avoid ambiguous matches.
ActionTry it
Create Section (API v1)
Tool 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.
ActionTry it
Create Section (Deprecated)
DEPRECATED: 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.
ActionTry it
Create task
Create a new task in Todoist using the unified API v1. This action allows users to create tasks with various parameters including content, due dates, priority, and more. The task can be created in a specific project, section, or as a subtask of another task. Bulk creation may trigger HTTP 429; honor Retry-After response headers.
ActionTry it
Delete Comment
Tool to delete a specific comment from Todoist by its ID. Use when you need to permanently remove a comment.
ActionTry it
Delete Label (V1)
Tool to delete a personal label using API v1. Use when you need to permanently remove a label by its ID. All instances of the label will be removed from tasks.
ActionTry it
Delete Project (API v1)
Tool 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.
ActionTry it
Delete Section (v1)
Tool to delete a section and all tasks within it. Use when you need to permanently remove a section by its ID.
ActionTry it
Delete Task
Tool 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.
ActionTry it
Delete Task (API v1)
DEPRECATED: 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.
ActionTry it
Delete Upload
Tool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded.
ActionTry it
Export Template As File
Tool 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.
ActionTry it
Export Template As URL
Tool 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.
ActionTry it
Filter Tasks
Tool 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.
ActionTry it
Get All Comments
This tool retrieves all comments associated with a specific task or project in Todoist. You must provide exactly one of task_id or project_id (they are mutually exclusive - do not provide both). Returns a JSON array of comment objects with details such as id, posted_at, content, and attachment information.
ActionTry it
Get all projects
Get all projects from a user's Todoist account. Retrieves all active (non-archived) projects; use TODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTS for archived ones. Response returns the list in the projects field, with fields including project_id, name, color, parent project, sharing status, and is_inbox_project flag. Always reference projects by project_id — names are non-unique and may be localized. Detect the Inbox via is_inbox_project, not by name. Results are a point-in-time snapshot; re-call after structural changes before relying on cached project_ids. In large accounts, paginate until no next-page token remains to avoid missing projects. Check existing projects before creating new ones to prevent duplicates.
ActionTry it
Get All Tasks
Fetches 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
ActionTry it
Get Backups
Tool to list all available backup archives for the user. Returns archive metadata only — not live task or project data; do not use as a proxy for active data availability. May return an empty list if no backups exist or backups are not enabled. For completed task history, use /sync/v9/completed/get_all instead.
ActionTry it
Get Comment (V1)
Tool to retrieve a single comment by ID using the v1 API. Use when you need to fetch details of a specific comment.
ActionTry it
Get Completed Tasks By Completion Date
Tool 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.
ActionTry it
Get Full Project Data
Tool to retrieve full project data including all sections, tasks, and collaborators. Use when you need comprehensive project information beyond basic metadata.
ActionTry it
Get ID Mappings
Tool 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.
ActionTry it
Get Personal Label
Tool to retrieve a personal label by its ID. Use when you need to fetch details about a specific personal label.
ActionTry it
Get Productivity Stats
Tool 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.
ActionTry it
Get Project (API v1)
Tool 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.
ActionTry it
Get Project Permissions
Tool 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.
ActionTry it
Get Section (v1 API)
Tool to retrieve a specific section by its ID using Todoist v1 API. Use when you need section metadata from the v1 endpoint.
ActionTry it
Get Special Backups
Tool to list special backup archives for the authenticated user's projects. Returns an empty list if no backups exist — callers must not assume archives are present. Read-only: confirms archive visibility only, not live task or project data access.
ActionTry it
Get Task (API v1)
Tool 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.
ActionTry it
Get Task (Deprecated)
DEPRECATED: Use TODOIST_GET_TASK2 instead. Tool to retrieve a specific task by its ID. Use when you need to fetch all details of an existing task before processing or display. Comments and attachments with additional context require separate API calls. Rate limit: ~50 req/min; honor Retry-After on HTTP 429.
ActionTry it
Get User
Tool to retrieve information about the currently authenticated user. Use when you need user details like email, name, preferences, karma, or subscription status.
ActionTry it
Get Workspace Plan Details
Tool 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.
ActionTry it
Import Template Into Project By ID
Tool 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.
ActionTry it
Import Template Into Project From File
Tool 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.
ActionTry it
Invite Project Collaborator
Tool 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.
ActionTry it
List Activities
Tool 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.
ActionTry it
List All Workspace Invitations
Tool 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.
ActionTry it
List Archived Projects
Tool to get all archived projects from Todoist. Use when you need to retrieve archived projects with pagination support.
ActionTry it
List Archived Sections
Tool to retrieve all archived sections for a specific project in Todoist. Use when you need to access sections that have been archived in a project.
ActionTry it
List Archived Workspace Projects
Tool 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.
ActionTry it
List Completed Tasks
Tool 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.
ActionTry it
List Completed Tasks By Due Date
Tool 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.
ActionTry it
List Filters
Tool to list all filters for the authenticated user. Use when you need to retrieve the current set of custom filters.
ActionTry it
List Joinable Workspaces
Tool to get workspaces the user can join. Use when you need to discover available workspaces that the authenticated user can join.
ActionTry it
List Labels
Tool to get all user labels with pagination support. Use when you need to retrieve labels from the user's Todoist account.
ActionTry it
List Pending Workspace Invitations
Tool to list pending invitation emails in a workspace. Use when you need to check which email invites are still pending acceptance in a workspace.
ActionTry it
List Project Collaborators
Tool 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.
ActionTry it
List Sections
Tool to get all active sections for the user, with optional filtering by project. Supports cursor-based pagination to handle large result sets.
ActionTry it
List Shared Labels
Tool 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.
ActionTry it
List Workspace Active Projects
Tool to list all active workspace projects. Returns active projects that are visible to the user, including those not yet joined. For guest users, only joined workspace projects are returned.
ActionTry it
List Workspace Archived Projects
Tool 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.
ActionTry it
List Workspace Invitations
Tool 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.
ActionTry it
List Workspace Users
Tool 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.
ActionTry it
Move Task
Tool to move a task to another project, section, or parent task while preserving task identity and metadata. Use when you need to relocate a task without recreating it.
ActionTry it
Move Task (REST API)
Tool 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.
ActionTry it
Quick Add Task
Tool 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.
ActionTry it
Remove Shared Label (API v1)
Tool 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.
ActionTry it
Rename Shared Labels (API v1)
Tool to rename a shared label across all active tasks using API v1. Use when you need to change the name of a shared label.
ActionTry it
Reopen Task (API v1)
Tool 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.
ActionTry it
Reorder Tasks
Reorder tasks deterministically by updating child_order in bulk via the Sync API item_reorder command. Use when you need to set specific ordering for tasks.
ActionTry it
Search Labels
Tool to search user labels by name with case-insensitive matching. Use when you need to find specific labels by name pattern.
ActionTry it
Search Projects
Search active user projects by name with support for wildcards and pagination. Use when you need to find projects matching a specific name pattern.
ActionTry it
Search Sections
Tool 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.
ActionTry it
Todoist Sync
Tool 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.
ActionTry it
Unarchive Project (API v1)
Tool 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).
ActionTry it
Update Comment (v1)
Tool 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.
ActionTry it
Update Label (API v1)
Tool to update an existing label using API v1. Use when you need to modify a label's name, color, order, or favorite status.
ActionTry it
Update Notification Setting
Tool to update notification settings for the current user. Use when you need to enable or disable notifications for specific event types and channels.
ActionTry it
Update Project (API v1)
Tool 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.
ActionTry it
Update Project (Deprecated)
DEPRECATED: 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.
ActionTry it
Update Section (Deprecated)
DEPRECATED: 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.
ActionTry it
Update Section (v1)
Tool to update an existing section by its ID using Todoist v1 API. Use when you need to rename a section.
ActionTry it
Update Task
Tool 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.
ActionTry it
Update Workspace Logo
Tool 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.
ActionTry it
Upload File
Tool 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.
ActionTry it