Todoist MCP server for your AI

Marks a project as archived.

Complete a task the way the Todoist apps do: a normal task is marked done (with its subtasks); a recurring task moves to its next date instead.

Creates a new project and returns it

Create a new task.

Delete a task and all of its subtasks.

Active tasks matching a Todoist filter query, the same syntax as the apps' filters: today, overdue, tomorrow, 7 days, no date, p1, #Project, ##Project (with sub-projects), /Section, @label, assigned to: me, search: word, combined with & (and), | (or), ! (not) and parentheses.

Returns a project object related to the given ID

A project with everything in it in one call: the project, its sections, its active tasks, its collaborators and its comment count.

Returns a single active (non-completed) task by ID

Completed tasks whose completion time falls between since and until (at most 3 months apart), newest first, optionally only in one project, section, parent task or workspace, or matching filter_query.

Get all collaborators for a given project.

Get all active user projects, optionally filtered by folder or workspace.

Get all active tasks for the user.

Moves task to another project, section or parent.

Add a task from one line of natural language, parsed exactly like the Todoist apps' Quick Add: dates (today, tomorrow at 5pm, every monday), #Project, /Section, @label, p1 to p4, +assignee, {deadline} and // description.

Reopens a task.

Full-text search over the user's completed tasks.

Updates a project and returns it.

Updates an existing task.

Create a new reminder for a task.

Create a personal label.

Create a new section

Get comprehensive productivity statistics for the authenticated user.

Get information about the currently authenticated user.

Get all user labels.

Get all active sections for the user, optionally filtered by project or workspace.

The user's saved personal filters: id, name, query (Todoist filter syntax), color, order and whether each is a favorite.

Creates a new comment on a project or task and returns it.

Get all comments for a given task or project.

Add up to 50 tasks in one call (one Todoist request): each with its own content, project, section, parent, due date in words (due_string: "tomorrow at 5pm"), deadline, priority ("p1" most urgent) and labels.

Complete up to 100 tasks in one call (one Todoist request), the way the apps do: a normal task is marked done with its subtasks, a recurring task moves to its next date.

What is on the user's plate now: overdue tasks and today's tasks (Todoist's own today | overdue filter), grouped by project with project names, plus how many active projects there are.

Run up to 100 Sync commands in one request, in order: for example create a project and add tasks to it in one go, using temp_id to refer to the new project.

Get activity logs.

Accept a workspace invitation.

Creates a new workspace and returns it.

Deletes a workspace.

Deletes a workspace invitation.

Returns a workspace by ID.

Each workspace member with their task activity (active, completed and overdue counts).

Lists details of the workspace's current plan and usage

Invites users to a workspace by email.

Join a workspace via link or via workspace ID, if the user can auto-join the workspace by domain.

Leave a workspace.

Return a list containing details of all pending invitation to a workspace.

Returns all active workspace projects, including those visible but not joined by the user.

Return archived projects in a workspace.

Return a list of user emails who have a pending invitation to a workspace.

The tasks assigned to one member of a workspace.

Returns all workspace_users for a given workspace if workspace_id is provided.

Returns all workspaces where the user is a member.

Reject a workspace invitation.

Removes an user from a workspace.

Resend a Workspace Invitation.

Updates an existing workspace and returns it.

Set a workspace's logo image, or remove it with delete true.

Update user sidebar preference.

Updates a workspace user's role.

Complete a recurring task.

Complete task.

How many archived projects the user has, optionally only in one workspace or only the ones the user joined.

Deletes a project and all of its sections and tasks.

How many completed tasks each active project, section and parent task holds (and archived sections per project).

Returns a list of all the available roles and the associated actions they can perform in a project.

_Only used for workspaces_ This endpoint is used to join a workspace project by a workspace_user and is only usable by the workspace user.

Leave a project.

Get the user's archived projects.

Completed tasks whose DUE date falls between since and until (at most 6 weeks apart), optionally only in one project, section, parent task or workspace, or matching filter_query.

Move a project.

Search active user projects by name.

Marks a previously archived project as active again.

Clear locations.

Create a new location reminder for a task.

Delete a location reminder by ID.

Delete a reminder by ID.

Return a single location reminder by ID.

Return a single reminder by ID.

Get all active location reminders.

The saved places location reminders can use (name, latitude, longitude).

Get all active reminders.

Update an existing location reminder.

Update an existing reminder.

Marks a section as archived.

Deletes a personal label.

Delete the section and all of its tasks

Return a personal label by ID.

Which notification types the user gets by email and push.

Return the section for the given section ID

What the user's plan allows now and on the next plan: max projects, sections, tasks per project, labels, filters, collaborators, upload size, reminders, comments, activity log and more.

The user's reminder and completion-sound settings.

Returns a set of unique strings containing shared labels from active tasks.

Move a section.

Remove the given shared label from all active tasks

Rename the given shared label from all active tasks

Search user labels by name.

Search active sections by name, optionally filtered by project or workspace.

Marks a section as active again.

Update karma goals.

Update a personal label.

Update a notification delivery preference.

Update a section.

Update user's properties.

Update user settings.

Accept an invitation to join a shared project.

Change project role.

Add a filter.

Add a workspace filter.

Delete a personal filter.

Delete an invitation to join a shared project.

Delete a workspace filter.

Which actions each project role (creator, admin, read_write, edit_only, complete_only, read_only) may perform.

Everyone the user shares projects with (id, name, email) and, per project, each collaborator's state (active, invited...) and role.

Filters shared in the user's workspaces (team filters): id, workspace_id, name, query, color, order.

Reject an invitation to join a shared project.

Delete a collaborator.

Share a project with another user.

Update a filter.

Update a workspace filter.

Adds the authenticated user's reaction to a task or project comment and returns the updated comment.

Delete a comment by ID

Delete view option.

Returns a single comment by ID

Each project's default view (mode, grouping, sorting) that new viewers see.

The user's own task orderings (for example the Today and Upcoming order): one entry per task with its order_key.

Saved view customizations (grouping, sorting, filtering, list/board/calendar mode) for Today, Upcoming, projects, labels and filters.

Removes the authenticated user's reaction from a task or project comment.

Updates the default view options for a project.

Set a view option.

Update a comment by ID and returns its content

Update an user item order.

Ask Todoist to assess a project's health again now.

Daily (and optionally weekly) counts of one kind of event in a project, for example completed tasks over the last weeks.

Todoist's health assessment of a project (status such as on track or at risk, with the reasons), from the last analysis.

The data a project health assessment is based on: task counts, overdue and recent activity.

How far along a project is: completed and active task counts and the share done.

Progress and health for the projects in a workspace.

Create a new folder in the given workspace.

Create a new project from a template file.

Delete a folder.

A project as a Todoist template CSV (its sections and tasks), returned as text.

A link to download a project as a Todoist template file.

Return the folder for the given folder ID.

Import a template file (a Todoist template CSV, for example one from export_project_template_file) into an existing project: its sections and tasks are added.

Import a saved template into an existing project.

Get all folders for a workspace.

The user's in-app notifications (shares, assignments, comments, completions, invitations...), newest first, with live_notifications_last_read_id: the last one marked read.

Mark all as read.

Mark as read.

Mark as unread.

Set last known.

Update an existing folder.

Return the current user's subscription state.

Read the caller's usage-billing credit state for a product.

Total the caller's settled usage over a window.

List the caller's usage-billing ledger entries, newest first.

Delete an uploaded file.

Disable the current email to a Todoist object

A download link for one backup archive (a zip of the account's data).

Translates IDs from v1 to v2 or vice versa.

New ids for objects that were moved.

Get or create an email to a Todoist object, currently only projects and tasks are supported.

The automatic backups Todoist keeps of the account (version and url per backup, newest first).

Read any Todoist data in one call through the Sync endpoint: pass resource_types, for example ["projects", "items", "sections", "labels"], or ["all"].

Upload a file (image, PDF, document, up to the plan's upload_limit_mb) to attach to a comment.