# Todoist (verified)

Todoist is a task management tool allowing users to create to-do lists, set deadlines, and collaborate on projects with reminders and cross-platform syncing

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add todoist

# Browse available tools
npx -y @smithery/cli@latest tool list todoist

# Get full schema for a tool
npx -y @smithery/cli@latest tool get todoist TODOIST_ADD_WORKSPACE

# Call a tool
npx -y @smithery/cli@latest tool call todoist TODOIST_ADD_WORKSPACE '{}'
```

## Direct MCP Connection

Endpoint: `https://todoist.run.tools`

## Tools (30)

- `TODOIST_ADD_WORKSPACE` — Tool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects. Generates UUID …
- `TODOIST_CLOSE_TASK` — This tool marks an existing task as completed in Todoist. It requires the `task_id` of the task to be closed.
- `TODOIST_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…
- `TODOIST_CREATE_LABEL` — Creates a new label.
- `TODOIST_CREATE_PROJECT` — Creates a new project in Todoist.
- `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 proje…
- `TODOIST_CREATE_TASK` — Create a new task in Todoist. This action allows users to create tasks with various parameters including content, due d…
- `TODOIST_DELETE_LABEL` — Tool to delete a specific label. Use when you need to permanently remove an unused label by its ID after confirming it'…
- `TODOIST_DELETE_PROJECT` — Tool to delete a specific Todoist project. Use when you need to permanently remove a project by its ID.
- `TODOIST_DELETE_SECTION` — Tool to delete a specific section. Use when you need to permanently remove unused section by its ID after confirming it…
- `TODOIST_DELETE_TASK` — Delete a task from Todoist. This action permanently removes the task and all its subtasks.
- `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…
- `TODOIST_GET_ALL_PROJECTS` — Get all projects from a user's Todoist account. This tool retrieves all projects from the authenticated user's Todoist …
- `TODOIST_GET_ALL_SECTIONS` — Tool to retrieve all the sections for a specific project in Todoist. Use when you need to list section structure within…
- `TODOIST_GET_ALL_TASKS` — Fetches all INCOMPLETE tasks from Todoist and returns their details. IMPORTANT LIMITATIONS: - This endpoint only return…
- `TODOIST_GET_BACKUPS` — Tool to list all available backup archives for the user. Use when you need to retrieve and review all existing backups.
- `TODOIST_GET_COMMENT` — Tool to retrieve details of a specific comment by its comment_id. Use when you need full information (content, timestam…
- `TODOIST_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.
- `TODOIST_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 u…
- `TODOIST_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 u…
- `TODOIST_GET_SPECIAL_BACKUPS` — Tool to list special backup archives for the user. Use when you need to retrieve all project backups for the authentica…
- `TODOIST_GET_TASK` — Tool to retrieve a specific task by its ID. Use when you need to fetch all details of an existing task before processin…
- `TODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTS` — Tool to list all archived projects in a workspace. Use when you need to retrieve archived workspace projects with optio…
- `TODOIST_LIST_FILTERS` — Tool to list all filters for the authenticated user. Use when you need to retrieve the current set of custom filters.
- `TODOIST_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…
- `TODOIST_REOPEN_TASK` — This tool reopens previously completed task.
- `TODOIST_UPDATE_COMMENT` — Tool to update a specific comment's content. Use when you need to correct or clarify an existing comment after confirmi…
- `TODOIST_UPDATE_PROJECT` — Tool to update a specific project's attributes such as name, color, indent, and order. Use when you need to rename or r…
- `TODOIST_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…
- `TODOIST_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 …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get todoist <tool-name>
```
