Create a new task in Todoist with optional description, due date, priority, labels, deadline, project, section, and duration for time blocking

Retrieve tasks from Todoist. Use 'filter' for Todoist filter syntax (e.g., 'today', 'p1') or 'task_name' for simple text search in task content

Update an existing task found by ID or partial name search. Supports updating content, description, due date, priority, labels, deadline, project, section, and duration

Delete a task found by ID or partial name search (case-insensitive)

Mark a task as complete found by ID or partial name search (case-insensitive)

Reopen a previously completed task found by ID or partial name search (case-insensitive). Use this to restore a task that was marked as complete.

Create multiple tasks at once for improved efficiency. Each task can have full attributes including duration for time blocking.

Update multiple tasks at once based on search criteria. Supports updating content, priority, due dates, labels, project, section, and duration.

Delete multiple tasks at once based on search criteria. Use with caution - this will permanently delete matching tasks.

Complete multiple tasks at once based on search criteria. Efficiently mark many tasks as done.

Retrieve completed tasks from Todoist. Uses the Sync API to fetch tasks that have been marked as complete. Supports filtering by project, date range, and pagination.

Create a task using natural language parsing like the Todoist app. The text is parsed to extract due dates, projects (#), labels (@), assignees (+), priorities (p1-p4), deadlines ({in 3 days}), and descriptions (//). Example: "Buy groceries tomorrow #Shopping @errands p1 {deadline Friday} //Don't forget milk"

Get a list of all projects from Todoist with their IDs, names, descriptions, and hierarchy information

Get a list of sections within a project from Todoist with their IDs and names

Create a new project in Todoist with optional sub-project hierarchy, description, and view style

Update an existing project in Todoist. Can modify name, color, favorite status, description, or view style.

Delete a project from Todoist. This will also delete all tasks and sub-projects within the project.

Archive or unarchive a project in Todoist. Archived projects are hidden from the main view but can be restored.

Get a list of collaborators for a shared project in Todoist. Returns collaborator names and emails.

Create a new section within a project in Todoist

Update an existing section in Todoist. Can update name by section ID or section name search.

Delete a section and all its tasks from Todoist. Can delete by section ID or section name search.

Get a list of collaborators for a shared project. Returns user IDs, names, and emails that can be used for task assignment with assignee_id.

Add a comment to a task or project in Todoist. For task comments, provide task_id or task_name. For project comments, provide project_id.

Get comments for a task or project in Todoist

Update an existing comment's content by comment ID

Delete a comment by its ID

Get all labels in Todoist

Create a new label in Todoist

Update an existing label in Todoist

Delete a label from Todoist

Get usage statistics for all labels in Todoist

Get all custom filters in Todoist. Filters are saved searches that help you organize and view tasks based on specific criteria. Note: Requires Todoist Pro or Business plan.

Create a new custom filter in Todoist. Filters use Todoist's query syntax (e.g., 'p1', 'today', '@label', '#project'). Note: Requires Todoist Pro or Business plan.

Update an existing filter in Todoist. Can update name, query, color, order, or favorite status. Note: Frozen filters (from cancelled subscriptions) cannot be modified.

Delete a filter from Todoist. This action cannot be undone. Note: Frozen filters (from cancelled subscriptions) cannot be deleted.

Create a new subtask under a parent task in Todoist

Create multiple subtasks under a parent task in a single operation

Convert an existing task to a subtask of another task

Promote a subtask to a main task (remove parent relationship)

Get a task with all its subtasks in a hierarchical structure

Get all reminders, optionally filtered by task. Reminders require Todoist Pro or Business plan.

Create a new reminder for a task. Supports three reminder types: relative (minutes before due), absolute (specific date/time), and location-based. Requires Todoist Pro or Business plan.

Update an existing reminder. Can change the type, timing, or location settings. Requires Todoist Pro or Business plan.

Delete a reminder. Requires Todoist Pro or Business plan.

Find duplicate or similar tasks using content similarity analysis. Returns grouped tasks that have similar titles, sorted by similarity percentage.

Merge duplicate tasks by keeping one task and completing or deleting the others. Use after todoist_duplicates_find to clean up duplicates.

Get Todoist activity log with optional filters. Returns events for items, notes, projects, sections, labels, filters, and reminders. Useful for auditing changes, tracking productivity, and understanding workspace history.

Get Todoist activity log for a specific project. Returns all events (tasks added/completed/deleted, comments, etc.) related to the project. Useful for project auditing and tracking project-specific changes.

Get Todoist activity log within a specific date range. Returns all events that occurred between the specified dates. Useful for generating activity reports and reviewing changes over time periods.

Move a task to a different project, section, or under a parent task. Uses Todoist Sync API for reliable movement operations.

Set the order of a task within its project/section. Lower numbers appear first.

Reorder multiple tasks at once by specifying their new positions. Efficient for reorganizing task lists.

Close a task. For recurring tasks, this completes the current occurrence and schedules the next one. For non-recurring tasks, this is equivalent to completing the task.

Update the day order of tasks in the Today view. Controls the order tasks appear when viewing today's tasks.

Move a section to a different project. All tasks in the section will move with it.

Reorder sections within a project by specifying their new positions.

Archive a section. Archived sections are hidden but not deleted. Tasks in the section are also archived.

Unarchive a previously archived section. Restores the section and its tasks to active status.

Reorder projects by specifying their new positions. Controls project ordering in the sidebar.

Move a project under another project (making it a sub-project) or to root level. Useful for organizing project hierarchies.

Get a list of all archived projects. Useful for reviewing or restoring archived projects.

Get information about the current Todoist user including name, email, timezone, karma, and account settings.

Get detailed productivity statistics including karma, task completion history, daily/weekly streaks, and goals progress.

Get user settings including reminder preferences, notification settings, sounds, and theme configuration.

Get all shared labels in the workspace. Shared labels are available in Todoist Business accounts for team collaboration.

Rename a shared label across all items in the workspace. Updates the label name for all team members. Requires Todoist Business account.

Remove a shared label from all items in the workspace. This removes the label from all tasks but does not delete the tasks. Requires Todoist Business account.

List all available automatic backups of your Todoist data. Todoist creates backups automatically. Returns version timestamps and download URLs.

Get the download URL for a specific backup version. The URL is time-limited. Backups are ZIP files containing CSV exports of your Todoist data.

Get all notes for a specific project. Project notes are shared with all project collaborators.

Create a new note for a project. Project notes are visible to all project collaborators.

Update an existing project note's content.

Delete a project note by ID.

Get all workspaces for the current user. Workspaces are available with Todoist Business accounts for team organization.

Get all pending project sharing invitations received by the current user.

Invite a user to collaborate on a project by email. The invitee will receive an email notification.

Accept a project sharing invitation. Requires both the invitation ID and secret from the invitation email.

Reject a project sharing invitation. Requires both the invitation ID and secret.

Delete/revoke a pending invitation that you sent. Use this to cancel an invitation before it is accepted.

Get live notifications including comments, assignments, sharing invitations, and other collaboration events.

Mark a specific notification as read.

Mark all notifications as read.

Test the connection to Todoist API and verify API token validity

Run comprehensive tests on all Todoist MCP features to verify functionality

Measure performance and response times of Todoist API operations