31 things your agent can do in Todoist

Get All Comments

This tool retrieves all comments associated with a specific task or project in todoist. it requires either a task id or a project id to fetch the comments, and it returns a json array of comment obje…

Get all labels

Get all personal labels from todoist. this action retrieves all personal labels from a user's todoist account. each label contains information like name, color, order and favorite status. api documen…

Get all projects

Get all projects from a user's todoist account. this tool retrieves all projects from the authenticated user's todoist account. the response includes details like project id, name, color, parent proj…

Get All Sections

Tool to retrieve all sections for a specific project in todoist. use when you need to list section structure within a project after selecting the project.

Get All Tasks

Fetches all tasks from todoist and returns their details.

Get Backups

Tool to list all available backup archives for the user. use when you need to retrieve and review all existing backups.

Get Label

Tool to retrieve a specific label by its id. use when you need detailed info about a label after you have its id.

Get Project

Tool to retrieve a specific project by its id. use when you have a project id and need its metadata before display or update.

Get Section

Tool to retrieve a specific section by its id. use when you have a section id and need its metadata before display or update.

Get Special Backups

Tool to list special backup archives for the user. use when you need to retrieve all project backups for the authenticated user after creating or managing projects.

Get Task

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.

List Archived Workspace Projects

Tool to list all archived projects in a workspace. use when you need to retrieve archived workspace projects with optional filters or pagination.

List Filters

Tool to list all filters for the authenticated user. use when you need to retrieve the current set of custom filters.

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.

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.

Create Label

Creates a new label.

Create Project

Creates a new project in todoist.

Create Section

Tool to create a new section within a specific project. use when you need to group tasks under a new heading in a project.

Create task

Create a new task in todoist. 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…

Delete Label

Tool to delete a specific label. use when you need to permanently remove an unused label by its id after confirming it's not in use. example: "delete label with id 2298391482".

Delete Project

Tool to delete a specific todoist project. use when you need to permanently remove a project by its id.

Delete Section

Tool to delete a specific section. use when you need to permanently remove an unused section by its id after confirming it's not in use. example: "delete section with id 82181370".

Delete task

Delete a task from todoist. this action permanently removes the task and all its subtasks.

Update Project

Tool to update a specific project's attributes such as name, color, indent, and order. use when you need to rename or reorder a project after reviewing its current settings. example: "update project…

Update Section

Tool to update a specific section's attributes such as name and order. use when you need to rename or reorder a section after confirming its id.

Update Task

Tool to update an existing task's properties. use when you need to modify a task's details after confirming its id and new values.

Create Comment

Tool to create a new comment in todoist. use when you need to add a note to a specific task or project after confirming its id.

Get Comment

Tool to retrieve details of a specific comment by its comment id. use when you need full information (content, timestamp, or attachment) about a known comment.

Update Comment

Tool to update a specific comment's content. use when you need to correct or clarify an existing comment after confirming its id and the new text.

Close Task

This tool marks an existing task as completed in todoist. it requires the `task id` of the task to be closed.

Reopen Task

This tool reopens a previously completed task.