close_tasks
Close tasks in Todoist Either 'task_id' or the 'task_name' to identify the target.
LABSCO SUMMARY
Restructuring a project stops being one call per task.
Nearly every write takes an items array, so moving a dozen tasks into a new section or relabelling a backlog is a single call, and because targets can be given by name, the usual lookup round trip disappears. get_tasks_by_filter carries Todoist's filter language, which is what makes everything overdue with a given label one query rather than a client-side scan. Completed history is the one hard boundary: the range tops out at 3 months.
What it is
36 tools over the Todoist API. Create, get, update and delete exist for tasks, projects, sections, labels and comments, each taking an items array, and most accept either an id or a name to identify what they act on.
What you get
- Tasks created, updated, closed, reopened, moved and deleted in batches, identified by task_id or task_name
- Todoist's own filter language for queries like today, overdue or P1, including date, label and project filters
- Completed tasks with a since and until window, over a range capped at 3 months
- Projects created, updated, deleted and moved under a new parent, plus the collaborators on one
- Sections listed per project and created, updated or deleted in bulk
- Personal labels created, updated and deleted, and shared labels renamed or removed across the account
- Comments on a task or project created, read, updated and deleted, and the colour set Todoist accepts
Requirements
A Todoist account and its API token, read from API_KEY. Node on your PATH.
Setup effort
One command plus a key — npx -y todoist-mcp, then supply credentials
USE CASES
01
Clearing what is overdue
Query in Todoist's own filter language, then close or reschedule the results in one batch instead of one call each.
02
Restructuring a project
Create the sections, move the tasks into them, and reparent the project itself if the shape changed. Every one of those takes a list.
03
Relabelling a backlog
Read the labels that exist, add the ones that do not, and apply them across the tasks in a single update call rather than opening each task.
04
Writing a weekly review
Completed tasks come back over a since and until window — up to 3 months — and the comments on them supply what the titles left out.
05
Capturing a batch of new work
A meeting's worth of actions goes in as one call, with their comments attached, instead of a task at a time.
36 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_comments
Create new comments in Todoist
create_labels
Create a new personal labels in Todoist
create_projects
Create new projects in Todoist
create_sections
Create new sections in Todoist
create_tasks
Create new tasks in Todoist
delete_comments
Delete comments in Todoist
delete_labels
Delete a personal label in Todoist Either 'id' or the 'name' to identify the target.
delete_projects
Delete projects from Todoist Either 'id' or the 'name' to identify the target.
delete_sections
Delete sections in Todoist Either 'id' or the 'name' to identify the target.
delete_tasks
Delete tasks from Todoist Either 'task_id' or the 'task_name' to identify the target.
get_collaborators
Get all collaborators for a project in Todoist
get_comments
Get comments from Todoist by ID
get_comments_list
Get comments list from Todoist
get_completed_tasks
Get completed tasks from Todoist with filtering options. Date range limited to 3 months max.
get_labels
Get a personal label from Todoist Either 'id' or the 'name' to identify the target.
get_labels_list
Get all personal labels from Todoist
get_projects
Get projects from Todoist Either 'id' or the 'name' to identify the target.
get_projects_list
Get all projects from Todoist
get_sections
Get sections from Todoist Either 'id' or the 'name' to identify the target.
get_sections_list
Get sections list from Todoist
get_shared_labels
Get all shared labels from Todoist
get_tasks
Get tasks from Todoist Either 'task_id' or the 'task_name' to identify the target.
get_tasks_by_filter
Get tasks from Todoist using filter language. Use for queries like "today", "overdue", "P1", date-based filters, label/project filters in query syntax
get_tasks_list
Get tasks list from Todoist. For advanced filtering use get_tasks_by_filter tool
move_projects
Move a projects to a different parent in Todoist
move_tasks
Move tasks to a different parent or section in Todoist. Exactly one of parent_id, section_id, or project_id must be provided
remove_shared_labels
Remove a shared label in Todoist
rename_shared_labels
Rename a shared label in Todoist
reopen_tasks
Reopen tasks in Todoist Either 'task_id' or the 'task_name' to identify the target.
update_comments
Update comments in Todoist
update_labels
Update a personal label in Todoist
update_projects
Update projects in Todoist Either 'id' or the 'name' to identify the target.
update_sections
Update sections in Todoist
update_tasks
Update tasks in Todoist Either 'task_id' or the 'task_name' to identify the target.
utils_get_colors
Get available colors for projects, labels, filters in Todoist
BEFORE YOU INSTALL
What to know first
Tools you get
36 tools when we connected. get_completed_tasks is available but missing from the documented tool list.
Requires
- npx on PATH
- API_KEY in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 36 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y todoist-mcpMCP Clients
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": [
"-y",
"todoist-mcp"
],
"env": {
"API_KEY": "<YOUR_API_KEY>"
}
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport stdio --scope project --env API_KEY=token todoist -- npx -y todoist-mcpCodex
CODEX · TOML
[mcp_servers.todoist]
command = "npx"
args = ["-y", "todoist-mcp"]
[mcp_servers.todoist.env]
API_KEY = "<YOUR_API_KEY>"Gemini CLI
GEMINI CLI · TERMINAL
gemini mcp add -e API_KEY=token todoist npx -y todoist-mcp
