todoist.com

•

One-click Login

About Todoist

The Todoist API (api.todoist.com) provides REST and Sync endpoints for programmatically managing tasks, projects, sections, labels, comments, and reminders. It is used to integrate Todoist into other apps and build automation workflows. API access is included with all Todoist plans at no extra charge. The platform raised prices in December 2025: Pro is now $5/month (annual). The Business plan adds shared workspaces, team projects, and role-based permissions on top of all Pro features.

AI Agent Use Cases

- Task creation, updating, completion, and deletion

- Project and section management with ordering

- Label and filter management for task organization

- Comment and file attachment handling per task

- Sync API for efficient bulk state synchronization

- Webhook support for real-time task and project event notifications

Available Actions

These are the specific actions that AI agents can perform with this tool

Create Filter

5 inputs

Creates a new task filter in Todoist to organize and view tasks based on custom criteria.

Inputs

name

Enter the new name

query

The query to search for. [Examples of searches](https://todoist.com/help/articles/introduction-to-filters) can be found in the Todoist help page.

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

order

Order in a list

favorite

Whether this is a favorite

Create Label

4 inputs

Creates a new personal label in Todoist for organizing and categorizing tasks.

Inputs

name

Enter the new name

order

Order in a list

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

favorite

Whether this is a favorite

Create Project

4 inputs

Creates a new project in Todoist to organize tasks under a specific workspace or user account

Inputs

name

Enter the new name

parent

Optional parent project

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

favorite

Whether this is a favorite

Create Project Comment

2 inputs

Adds a textual comment to a specified Todoist project to provide updates or additional information.

Inputs

project

Project to add a comment to

content

Comment content

Create Section

3 inputs

Creates a new section within a specified Todoist project to organize tasks more effectively

Inputs

project

Select a project to filter results by

name

Enter the new name

order

Order in a list

Create Task

14 inputs

Creates a new task in Todoist with specified attributes such as content, due date, and priority

Inputs

recurringInfoLabel

content

Task Content

description

Task description

project

Task project. If not set, task is put to user

section

The section to put task into

parent

Parent task

order

Order in a list

labels

Select labels to add to the task.

priority

Task priority from 1 (normal) to 4 (urgent)

dueString

[Human defined](https://todoist.com/help/articles/205325931) task due date (ex.: \

dueDate

Specific date in `YYYY-MM-DD` format relative to user’s timezone

dueDatetime

Specific date and time in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format in UTC.

dueLang

2-letter code specifying language in case `due_string` is not written in English

assignee

The responsible user (if set, and only for shared tasks)

Create Task Comment

3 inputs

Adds a new comment to a specified Todoist task to provide additional context or updates.

Inputs

project

Project containing the task to add a comment to

task

Task to add new comment to

content

Comment content

Delete Comment

3 inputs

Removes a specified comment from a Todoist task permanently

Inputs

project

Project containing the comment to delete

task

Task containing the comment to delete

commentId

Select a comment

Delete Filter

1 input

Deletes an existing filter from your Todoist account to remove custom task views.

Inputs

filter

Select the filter to update

Delete Label

1 input

Removes a specified label from your Todoist account, permanently deleting it.

Inputs

label

Select a label to filter results by

Delete Project

1 input

Removes a specified project from your Todoist account permanently.

Inputs

project

Select a project to filter results by

Delete Section

2 inputs

Deletes a specified section within a Todoist project to organize or remove unwanted sections.

Inputs

project

Select a project to filter results by

section

Select a section to filter results by

Delete Task

2 inputs

Deletes a specified task from your Todoist task list permanently

Inputs

project

Select a project to filter results by

task

Select the task to delete

Export Tasks

2 inputs

Exports the names of tasks from a specified Todoist project into a comma-separated values (CSV) file.

Inputs

project

Select a project to filter results by

syncDir

Find Project

2 inputs

Retrieves a Todoist project by its name and optionally creates it if it doesn't exist

Inputs

name

The name of the project to search for/create

createIfNotFound

Create this item if it is not found

Find Task

3 inputs

Searches for a task by its name in Todoist and optionally creates the task if it does not exist.

Inputs

project

Select a project to filter results by

content

The name of the task to search for/create

createIfNotFound

Create this item if it is not found

Find User

1 input

Searches for a user connected to your Todoist account using their email address.

Inputs

Email Address

Get Label

1 input

Retrieves detailed information about a specific label in your Todoist account.

Inputs

label

Select a label to filter results by

Get Project

1 input

Retrieves detailed information about a specific Todoist project by its ID

Inputs

project

Select a project to filter results by

Get Project Comment

2 inputs

Retrieves detailed information about a specific comment within a Todoist project.

Inputs

project

Project containing the comment

commentId

Select a comment

Get Section

2 inputs

Retrieves detailed information about a specific Todoist project section by its ID.

Inputs

project

Select a project to filter results by

sectionId

Select a section to filter results by

Get Task

2 inputs

Retrieves detailed information about a specific active task in Todoist by task ID

Inputs

project

Select a project to filter results by

task

Select a task to filter results by

Get Task Comment

3 inputs

Retrieves detailed information about a specific comment associated with a Todoist task

Inputs

project

Select a project to filter results by

task

Select a task to filter results by

commentId

Select a comment

Import Tasks

3 inputs

Imports multiple tasks into a specified Todoist project to efficiently add and organize actionable items.

Inputs

path

The .csv file to upload. Provide either a file URL or a path to a file in the `/tmp` directory (for example, `/tmp/myFile.csv`)

project

Project to import tasks into

syncDir

Invite User To Project

2 inputs

Sends an invitation email to a user to collaborate on a specified Todoist project

Inputs

project

Select a project to filter results by

Email Address

List Filters

Retrieves a comprehensive list of all custom filters available in the user's Todoist account

List Labels

Retrieves all personal labels created in the user's Todoist account

List Project Comments

1 input

Retrieves all comments associated with a specified Todoist project

Inputs

project

Select a project to filter results by

List Projects

Retrieves a complete list of all projects within the user's Todoist account.

List Sections

1 input

Retrieves all sections within Todoist projects to organize and categorize tasks.

Inputs

project

Select a project to filter results by

List Task Comments

2 inputs

Retrieves all comments associated with a specified Todoist task to provide insight and context on task discussions.

Inputs

project

Select a project to filter results by

task

Select a task to filter results by

List Uncompleted Tasks

3 inputs

Retrieves a list of all uncompleted tasks filtered by project, section, and/or label in Todoist.

Inputs

project

Select a project to filter results by

section

Select a section to filter results by

label

Select a label to filter results by

Mark Task as Completed

2 inputs

Marks a specified Todoist task as completed, updating its status accordingly.

Inputs

project

Select a project to filter results by

taskId

The task to mark as complete

Move Task To Section

3 inputs

Moves a specified task to another section within the same Todoist project to reorganize task structure.

Inputs

project

Project containing the task to move

task

Select a task to move

section

The section to move the task to

Search Tasks

4 inputs

Search and retrieve Todoist tasks filtered by task name, label, project, and/or section.

Inputs

name

Returns tasks that contain the specified string in their name

label

Select a label to filter results by

project

Select a project to filter results by

section

Select a section to filter results by

Uncomplete Task

2 inputs

Marks a completed Todoist task as incomplete, reopening it for further action.

Inputs

project

Select a project to filter results by

taskId

Select the task to reopen

Update Comment

4 inputs

Updates the content or metadata of an existing comment on a Todoist task.

Inputs

project

Project containing the comment to update

task

Task containing the comment to update

commentId

Select a comment

content

Comment content

Update Filter

6 inputs

Modifies an existing Todoist filter’s properties such as name or query to customize task views

Inputs

filter

Select the filter to update

name

Enter the new name

query

The query to search for. [Examples of searches](https://todoist.com/help/articles/introduction-to-filters) can be found in the Todoist help page.

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

order

Order in a list

favorite

Whether this is a favorite

Update Label

5 inputs

Updates the properties of an existing Todoist label such as its name or color.

Inputs

label

The label to update

name

Enter the new name

order

Order in a list

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

favorite

Whether this is a favorite

Update Project

4 inputs

Updates the details of an existing Todoist project such as its name, color, or parent project.

Inputs

projectId

The project to update

name

Enter the new name

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

favorite

Whether this is a favorite

Update Section

3 inputs

Updates the properties of an existing section within a Todoist project, such as its name or project association.

Inputs

project

Select a project to filter results by

section

The section to update

name

Enter the new name

Update Task

11 inputs

Modifies the details of an existing Todoist task such as content, due date, priority, or labels.

Inputs

project

The project containing the task to be updated

task

The task to update

content

Task Content

description

Task description

labels

Select labels to add to the task.

priority

Task priority from 1 (normal) to 4 (urgent)

dueString

[Human defined](https://todoist.com/help/articles/205325931) task due date (ex.: \

dueDate

Specific date in `YYYY-MM-DD` format relative to user’s timezone

dueDatetime

Specific date and time in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format in UTC.

dueLang

2-letter code specifying language in case `due_string` is not written in English

assignee

The responsible user (if set, and only for shared tasks)

About Todoist

AI Agent Use Cases

- Task creation, updating, completion, and deletion

- Project and section management with ordering

- Label and filter management for task organization

- Comment and file attachment handling per task

- Sync API for efficient bulk state synchronization

- Webhook support for real-time task and project event notifications

Available Actions

These are the specific actions that AI agents can perform with this tool

Create Filter

5 inputs

Creates a new task filter in Todoist to organize and view tasks based on custom criteria.

Inputs

name

Enter the new name

query

The query to search for. [Examples of searches](https://todoist.com/help/articles/introduction-to-filters) can be found in the Todoist help page.

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

order

Order in a list

favorite

Whether this is a favorite

Create Label

4 inputs

Creates a new personal label in Todoist for organizing and categorizing tasks.

Inputs

name

Enter the new name

order

Order in a list

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

favorite

Whether this is a favorite

Create Project

4 inputs

Creates a new project in Todoist to organize tasks under a specific workspace or user account

Inputs

name

Enter the new name

parent

Optional parent project

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

favorite

Whether this is a favorite

Create Project Comment

2 inputs

Adds a textual comment to a specified Todoist project to provide updates or additional information.

Inputs

project

Project to add a comment to

content

Comment content

Create Section

3 inputs

Creates a new section within a specified Todoist project to organize tasks more effectively

Inputs

project

Select a project to filter results by

name

Enter the new name

order

Order in a list

Create Task

14 inputs

Creates a new task in Todoist with specified attributes such as content, due date, and priority

Inputs

recurringInfoLabel

content

Task Content

description

Task description

project

Task project. If not set, task is put to user

section

The section to put task into

parent

Parent task

order

Order in a list

labels

Select labels to add to the task.

priority

Task priority from 1 (normal) to 4 (urgent)

dueString

[Human defined](https://todoist.com/help/articles/205325931) task due date (ex.: \

dueDate

Specific date in `YYYY-MM-DD` format relative to user’s timezone

dueDatetime

Specific date and time in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format in UTC.

dueLang

2-letter code specifying language in case `due_string` is not written in English

assignee

The responsible user (if set, and only for shared tasks)

Create Task Comment

3 inputs

Adds a new comment to a specified Todoist task to provide additional context or updates.

Inputs

project

Project containing the task to add a comment to

task

Task to add new comment to

content

Comment content

Delete Comment

3 inputs

Removes a specified comment from a Todoist task permanently

Inputs

project

Project containing the comment to delete

task

Task containing the comment to delete

commentId

Select a comment

Delete Filter

1 input

Deletes an existing filter from your Todoist account to remove custom task views.

Inputs

filter

Select the filter to update

Delete Label

1 input

Removes a specified label from your Todoist account, permanently deleting it.

Inputs

label

Select a label to filter results by

Delete Project

1 input

Removes a specified project from your Todoist account permanently.

Inputs

project

Select a project to filter results by

Delete Section

2 inputs

Deletes a specified section within a Todoist project to organize or remove unwanted sections.

Inputs

project

Select a project to filter results by

section

Select a section to filter results by

Delete Task

2 inputs

Deletes a specified task from your Todoist task list permanently

Inputs

project

Select a project to filter results by

task

Select the task to delete

Export Tasks

2 inputs

Exports the names of tasks from a specified Todoist project into a comma-separated values (CSV) file.

Inputs

project

Select a project to filter results by

syncDir

Find Project

2 inputs

Retrieves a Todoist project by its name and optionally creates it if it doesn't exist

Inputs

name

The name of the project to search for/create

createIfNotFound

Create this item if it is not found

Find Task

3 inputs

Searches for a task by its name in Todoist and optionally creates the task if it does not exist.

Inputs

project

Select a project to filter results by

content

The name of the task to search for/create

createIfNotFound

Create this item if it is not found

Find User

1 input

Searches for a user connected to your Todoist account using their email address.

Inputs

Email Address

Get Label

1 input

Retrieves detailed information about a specific label in your Todoist account.

Inputs

label

Select a label to filter results by

Get Project

1 input

Retrieves detailed information about a specific Todoist project by its ID

Inputs

project

Select a project to filter results by

Get Project Comment

2 inputs

Retrieves detailed information about a specific comment within a Todoist project.

Inputs

project

Project containing the comment

commentId

Select a comment

Get Section

2 inputs

Retrieves detailed information about a specific Todoist project section by its ID.

Inputs

project

Select a project to filter results by

sectionId

Select a section to filter results by

Get Task

2 inputs

Retrieves detailed information about a specific active task in Todoist by task ID

Inputs

project

Select a project to filter results by

task

Select a task to filter results by

Get Task Comment

3 inputs

Retrieves detailed information about a specific comment associated with a Todoist task

Inputs

project

Select a project to filter results by

task

Select a task to filter results by

commentId

Select a comment

Import Tasks

3 inputs

Imports multiple tasks into a specified Todoist project to efficiently add and organize actionable items.

Inputs

path

The .csv file to upload. Provide either a file URL or a path to a file in the `/tmp` directory (for example, `/tmp/myFile.csv`)

project

Project to import tasks into

syncDir

Invite User To Project

2 inputs

Sends an invitation email to a user to collaborate on a specified Todoist project

Inputs

project

Select a project to filter results by

Email Address

List Filters

Retrieves a comprehensive list of all custom filters available in the user's Todoist account

List Labels

Retrieves all personal labels created in the user's Todoist account

List Project Comments

1 input

Retrieves all comments associated with a specified Todoist project

Inputs

project

Select a project to filter results by

List Projects

Retrieves a complete list of all projects within the user's Todoist account.

List Sections

1 input

Retrieves all sections within Todoist projects to organize and categorize tasks.

Inputs

project

Select a project to filter results by

List Task Comments

2 inputs

Retrieves all comments associated with a specified Todoist task to provide insight and context on task discussions.

Inputs

project

Select a project to filter results by

task

Select a task to filter results by

List Uncompleted Tasks

3 inputs

Retrieves a list of all uncompleted tasks filtered by project, section, and/or label in Todoist.

Inputs

project

Select a project to filter results by

section

Select a section to filter results by

label

Select a label to filter results by

Mark Task as Completed

2 inputs

Marks a specified Todoist task as completed, updating its status accordingly.

Inputs

project

Select a project to filter results by

taskId

The task to mark as complete

Move Task To Section

3 inputs

Moves a specified task to another section within the same Todoist project to reorganize task structure.

Inputs

project

Project containing the task to move

task

Select a task to move

section

The section to move the task to

Search Tasks

4 inputs

Search and retrieve Todoist tasks filtered by task name, label, project, and/or section.

Inputs

name

Returns tasks that contain the specified string in their name

label

Select a label to filter results by

project

Select a project to filter results by

section

Select a section to filter results by

Uncomplete Task

2 inputs

Marks a completed Todoist task as incomplete, reopening it for further action.

Inputs

project

Select a project to filter results by

taskId

Select the task to reopen

Update Comment

4 inputs

Updates the content or metadata of an existing comment on a Todoist task.

Inputs

project

Project containing the comment to update

task

Task containing the comment to update

commentId

Select a comment

content

Comment content

Update Filter

6 inputs

Modifies an existing Todoist filter’s properties such as name or query to customize task views

Inputs

filter

Select the filter to update

name

Enter the new name

query

The query to search for. [Examples of searches](https://todoist.com/help/articles/introduction-to-filters) can be found in the Todoist help page.

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

order

Order in a list

favorite

Whether this is a favorite

Update Label

5 inputs

Updates the properties of an existing Todoist label such as its name or color.

Inputs

label

The label to update

name

Enter the new name

order

Order in a list

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

favorite

Whether this is a favorite

Update Project

4 inputs

Updates the details of an existing Todoist project such as its name, color, or parent project.

Inputs

projectId

The project to update

name

Enter the new name

color

A numeric ID representing a color. Refer to the id column in the [Colors](https://developer.todoist.com/guides/#colors) guide for more info.

favorite

Whether this is a favorite

Update Section

3 inputs

Updates the properties of an existing section within a Todoist project, such as its name or project association.

Inputs

project

Select a project to filter results by

section

The section to update

name

Enter the new name

Update Task

11 inputs

Modifies the details of an existing Todoist task such as content, due date, priority, or labels.

Inputs

project

The project containing the task to be updated

task

The task to update

content

Task Content

description

Task description

labels

Select labels to add to the task.

priority

Task priority from 1 (normal) to 4 (urgent)

dueString

[Human defined](https://todoist.com/help/articles/205325931) task due date (ex.: \

dueDate

Specific date in `YYYY-MM-DD` format relative to user’s timezone

dueDatetime

Specific date and time in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) format in UTC.

dueLang

2-letter code specifying language in case `due_string` is not written in English

assignee

The responsible user (if set, and only for shared tasks)