Todoist

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 todoist · 84 tools · 1 triggers

Connect it

run auth todoist
run auth todoist --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run todoist          # common commands
run todoist --all    # every command

import { todoist } from "@boxd/run";

Common tools

Tool	What it does
`add-workspace`	Tool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects.
`archive-project2`	Tool to archive a project using Todoist API v1. For personal projects, archives it for the initiating user.
`bulk-create-tasks`	Create many tasks in one request using Todoist’s Sync batching.
`close-task`	DEPRECATED: Use TODOIST_CLOSE_TASK_V1 instead. This tool marks an existing task as completed in Todoist.
`close-task-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.
`create-comment-v1`	Tool to create a new comment on a project or task using Todoist API v1.
`create-label`	DEPRECATED: Use TODOIST_CREATE_LABEL_V1 instead. Creates a new label.
`create-label-v1`	Tool to create a new personal label using API v1. Use when you need to add a new label to organize tasks.
`create-project`	DEPRECATED: Use TODOIST_TODOIST_CREATE_PROJECT2 instead. Creates a new project in Todoist.
`create-project2`	Tool to create a new project in Todoist using the unified API v1.
`create-section`	DEPRECATED: Use TODOIST_CREATE_SECTION_V1 instead. Tool to create a new section within a specific project.
`create-section-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.
`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.
`delete-comment`	Tool to delete a specific comment from Todoist by its ID. Use when you need to permanently remove a comment.
`delete-label-v1`	Tool to delete a personal label using API v1. Use when you need to permanently remove a label by its ID.
`delete-project2`	Tool to delete a project and all of its sections and tasks using Todoist API v1.
`delete-section2`	Tool to delete a section and all tasks within it. Use when you need to permanently remove a section by its ID.
`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.
`delete-task-v1`	DEPRECATED: Use TODOIST_DELETE_TASK instead. Tool to delete a specific task from Todoist using API v1.
`delete-upload`	Tool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded.
`export-template-as-url`	Tool to export a Todoist project as a shareable template URL.
`filter-tasks`	Tool to get all tasks matching the filter. Use when you need to retrieve tasks based on specific filter criteria.
`get-all-comments`	This tool retrieves all comments associated with a specific task or project in Todoist.
`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.
`get-all-tasks`	Fetches all INCOMPLETE tasks from Todoist and returns their details.

All 84 tools

Tool	What it does
`add-workspace`	Tool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects.
`archive-project2`	Tool to archive a project using Todoist API v1. For personal projects, archives it for the initiating user.
`bulk-create-tasks`	Create many tasks in one request using Todoist’s Sync batching.
`close-task`	DEPRECATED: Use TODOIST_CLOSE_TASK_V1 instead. This tool marks an existing task as completed in Todoist.
`close-task-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.
`create-comment-v1`	Tool to create a new comment on a project or task using Todoist API v1.
`create-label`	DEPRECATED: Use TODOIST_CREATE_LABEL_V1 instead. Creates a new label.
`create-label-v1`	Tool to create a new personal label using API v1. Use when you need to add a new label to organize tasks.
`create-project`	DEPRECATED: Use TODOIST_TODOIST_CREATE_PROJECT2 instead. Creates a new project in Todoist.
`create-project2`	Tool to create a new project in Todoist using the unified API v1.
`create-section`	DEPRECATED: Use TODOIST_CREATE_SECTION_V1 instead. Tool to create a new section within a specific project.
`create-section-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.
`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.
`delete-comment`	Tool to delete a specific comment from Todoist by its ID. Use when you need to permanently remove a comment.
`delete-label-v1`	Tool to delete a personal label using API v1. Use when you need to permanently remove a label by its ID.
`delete-project2`	Tool to delete a project and all of its sections and tasks using Todoist API v1.
`delete-section2`	Tool to delete a section and all tasks within it. Use when you need to permanently remove a section by its ID.
`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.
`delete-task-v1`	DEPRECATED: Use TODOIST_DELETE_TASK instead. Tool to delete a specific task from Todoist using API v1.
`delete-upload`	Tool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded.
`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.
`export-template-as-url`	Tool to export a Todoist project as a shareable template URL.
`filter-tasks`	Tool to get all tasks matching the filter. Use when you need to retrieve tasks based on specific filter criteria.
`get-all-comments`	This tool retrieves all comments associated with a specific task or project in Todoist.
`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.
`get-all-tasks`	Fetches all INCOMPLETE tasks from Todoist and returns their details.
`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…
`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.
`get-completed-tasks-by-completion-date`	Tool to retrieve completed tasks within a specified completion date window.
`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…
`get-personal-label`	Tool to retrieve a personal label by its ID. Use when you need to fetch details about a specific personal label.
`get-productivity-stats`	Tool to retrieve comprehensive productivity statistics for the authenticated user.
`get-project`	Tool to retrieve a specific project by its ID using Todoist API v1.
`get-project-full`	Tool to retrieve full project data including all sections, tasks, and collaborators.
`get-project-permissions`	Tool to retrieve all available roles and their associated actions in Todoist projects.
`get-section-v1`	Tool to retrieve a specific section by its ID using Todoist v1 API.
`get-special-backups`	Tool to list special backup archives for the authenticated user’s projects.
`get-task`	DEPRECATED: Use TODOIST_GET_TASK2 instead. Tool to retrieve a specific task by its ID.
`get-task2`	Tool to retrieve a single active (non-completed) task by ID using API v1.
`get-user`	Tool to retrieve information about the currently authenticated user.
`get-workspace-plan-details`	Tool to retrieve details about a workspace’s current plan and usage.
`import-template-into-project-by-id`	Tool to import a template from Todoist’s template gallery into an existing project.
`import-template-into-project-from-file`	Tool to import a CSV template into an existing Todoist project from a file.
`invite-project-collaborator`	Tool to invite a collaborator to a Todoist project by email.
`list-activities`	Tool to get activity logs from Todoist. Returns a paginated list of activity events for the user.
`list-all-invitations-workspaces`	Tool to return a list containing details of all pending invitations to a workspace.
`list-archived-projects`	Tool to get all archived projects from Todoist. Use when you need to retrieve archived projects with pagination support.
`list-archived-sections`	Tool to retrieve all archived sections for a specific project in Todoist.
`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…
`list-completed-tasks`	Tool to retrieve all completed tasks with optional project filtering.
`list-completed-tasks-by-due-date`	Tool to retrieve completed tasks within a specified due date range (up to 6 weeks).
`list-filters`	Tool to list all filters for the authenticated user. Use when you need to retrieve the current set of custom filters.
`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.
`list-labels`	Tool to get all user labels with pagination support. Use when you need to retrieve labels from the user’s Todoist account.
`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.
`list-project-collaborators`	Tool to get all collaborators for a given project with cursor-based pagination.
`list-sections`	Tool to get all active sections for the user, with optional filtering by project.
`list-shared-labels`	Tool to retrieve shared label names from active tasks with pagination support.
`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.
`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.
`list-workspace-invitations`	Tool to list user emails with pending invitations to a workspace.
`list-workspace-users`	Tool to list users in workspace(s). Use when you need to retrieve workspace members.
`move-task`	Tool to move a task to another project, section, or parent task while preserving task identity and metadata.
`move-task-rest-api`	Tool to move a task to another project, section, or parent task using the REST API.
`quick-add-task`	Tool to add tasks using natural language parsing similar to the official Todoist clients.
`remove-shared-label-v1`	Tool to remove a shared label from all active tasks using API v1.
`rename-shared-labels-v1`	Tool to rename a shared label across all active tasks using API v1.
`reopen-task2`	Tool to reopen a completed task in Todoist using API v1. Use when you need to restore a previously completed task.
`reorder-tasks`	Reorder tasks deterministically by updating child_order in bulk via the Sync API item_reorder command.
`search-labels`	Tool to search user labels by name with case-insensitive matching.
`search-projects`	Search active user projects by name with support for wildcards and pagination.
`search-sections`	Tool to search active sections by name, optionally filtered by project.
`sync`	Tool to sync data with Todoist server, supporting both read and write operations.
`unarchive-project2`	Tool to unarchive a previously archived Todoist project using API v1.
`update-comment2`	Tool to update a comment by ID and return its content via v1 API.
`update-label-v1-second`	Tool to update an existing label using API v1. Use when you need to modify a label’s name, color, order, or favorite status.
`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.
`update-project`	DEPRECATED: Use TODOIST_TODOIST_UPDATE_PROJECT2 instead. Tool to update a project’s properties including name, color, favorite status, and view style.
`update-project2`	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.
`update-section`	DEPRECATED: Use TODOIST_TODOIST_UPDATE_SECTION2 instead. Tool to update a specific section’s name.
`update-section2`	Tool to update an existing section by its ID using Todoist v1 API.
`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.
`update-workspace-logo`	Tool to upload an image as the workspace logo or delete the existing logo.
`upload-file`	Tool to upload a file to Todoist. Use when you need to attach files to tasks or projects.

Triggers (1)

Subscribe with .on(...) in a script. A trigger with required configuration takes it as the second argument.

Trigger	Needs	What fires it
New Task Created	nothing	Trigger when a new task is added to Todoist.

Open Todoist in the console →

Getting started

Guides

Integrations & automations

Use cases

References

Connect it

Use it

Common tools

Triggers (1)

​Connect it

​Use it

​Common tools

​Triggers (1)

Connect it

Use it

Common tools

Triggers (1)