todoist_complete_task
Mark a task as complete by searching for it by name
LABSCO SUMMARY
Nothing in the loop needs a task ID.
todoist_update_task, todoist_complete_task and todoist_delete_task each take a task name and search for it, which is what makes this usable from a sentence typed in passing rather than from a client where you can see identifiers. The same choice sets the ceiling: name matching is the only addressing on offer, and the five tools cover tasks alone — projects, sections, labels, comments and reminders are read and written elsewhere or not at all.
What it is
A five-tool Todoist client in which every write finds its task by name rather than by ID.
What you get
- Tasks created with a description, a due date written as a plain string, and a priority
- Task lists filtered by project, priority or a Todoist filter expression, with a result limit
- An existing task located by name and then updated — its content, description, due string or priority
- A task completed or deleted by naming it, without looking an ID up first
Requirements
A Todoist account, with its API token in TODOIST_API_TOKEN. No other credential is involved, and no plan tier is named by any of the five tools.
Setup effort
One command plus a key — npm install -g @abhiz123/todoist-mcp-server, then supply credentials
USE CASES
01
Capturing a task in the middle of talking about something else
One call takes the task, a description, a due date written the way you would say it, and a priority. Nothing has to be looked up first.
02
Clearing what is due today by name
Filter the list down to the project or priority in question, then close items by naming them — the completion call searches for the task itself.
03
Dealing with something you are not going to get to
Push it out by rewriting the due string, or drop it entirely. Both address the task by name, so this works from a sentence rather than from a list with IDs in it.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
todoist_create_task
Create a new task in Todoist with optional description, due date, and priority
todoist_delete_task
Delete a task from Todoist by searching for it by name
todoist_get_tasks
Get a list of tasks from Todoist with various filters
todoist_update_task
Update an existing task in Todoist by searching for it by name and then updating it
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected. todoist_update_task, todoist_complete_task and todoist_delete_task find tasks by partial name match with no confirmation, so a vague instruction can hit the wrong task. Only tasks are covered: no projects, sections, labels or comments.
Requires
- npx on PATH
- TODOIST_API_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @abhiz123/todoist-mcp-serverMCP Clients
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": [
"-y",
"@abhiz123/todoist-mcp-server"
],
"env": {
"TODOIST_API_TOKEN": "<YOUR_TODOIST_API_TOKEN>"
}
}
}
}
