List all Todoist projects.

Returns every project in the user's account with its ID and name. Use this to discover valid project names for other tools.

Example: list_todoist_projects()

Returns: [{"id": "12345", "name": "Inbox"}, {"id": "67890", "name": "Work Tasks"}, ...]

Get all tasks from a Todoist project.

Returns tasks with: id, content, description, labels, due, priority, project_id.

List all personal Todoist labels.

Returns every label with its ID, name, and color. Labels are referenced by name in task operations.

Example: list_todoist_labels()

Returns: [{"id": "111", "name": "Home", "color": "blue"}, ...]

Get completed tasks from Todoist within a date range.

Returns tasks completed between since and until (inclusive). Ideal for weekly review metrics — see how many tasks were completed and when.

Example: get_completed_tasks(since="2026-03-12", until="2026-03-19")

Returns: [{"id": "123", "content": "Buy milk", "project_id": "456", ...}, ...]

Create a new task in Todoist.

Creates a task with the given content in the specified project. Optionally attach labels, a due date, and a description.

Update fields on an existing Todoist task.

Only specified fields are changed; others remain untouched. Note: setting labels replaces all existing labels on the task.

Move a task to a different Todoist project.

Mark a Todoist task as complete.

The task will be moved to completed status. For recurring tasks, this advances to the next occurrence.

Permanently delete a Todoist task.

This action is irreversible. Consider complete_task() instead if you want to keep a record of the task.

Batch update multiple Todoist tasks in a single API call.

Uses the Todoist Sync API for efficiency — processes all operations in one request. Each operation can update fields and/or move a task to a different project. This is ideal for triage workflows where you need to process many tasks at once.

Get all comments on a Todoist task.

Returns all comments attached to the specified task, ordered by creation time.

Add a comment to a Todoist task.

Creates a new comment on the specified task. Supports Markdown formatting.

Create a new personal label in Todoist.

Rename an existing Todoist label.

Permanently delete a Todoist label.

This removes the label from all tasks that have it. This action is irreversible.