add_comment
Add a comment to a task
LABSCO SUMMARY
close_task and reopen_task as separate calls is the small completeness that matters — undoing a mistaken completion is otherwise a trip to the app.
Most task-manager integrations implement create, list and complete, which covers the demo and not the work. An agent working through a list will occasionally close the wrong thing, and without a reopen call the correction has to happen somewhere else. The same completeness shows in sections and labels having their own full sets: those are how people actually organise, and an integration that can add a task but not put it in the right section produces an inbox someone has to sort by hand afterwards. Straightforward surface, no surprises, and that is the point.
What it is
A Todoist client covering all five object types the service is built from: tasks, projects, sections, labels and comments, each with create, read, update and delete.
What you get
- Tasks have a complete lifecycle rather than just create and complete: add, update, get, list with filters, close, reopen and delete — reopen being the one most integrations leave out.
- Projects with their collaborators, so who has access is readable without opening the app.
- Sections as first-class objects, which is what makes a project's internal structure editable rather than only its contents.
- Labels and comments with their own full sets, so the metadata people actually organise by is reachable.
- list_tasks and list_comments both filter, so a query returns the slice you asked for instead of everything.
Requirements
TODOIST_API_TOKEN.
Setup effort
One command plus a key — npx -y @ganiev/todoist-mcp-server, then supply credentials
USE CASES
01
Capturing something while you are still talking about it
Add the task with its project and labels from the conversation, rather than remembering to file it later.
02
Working through a filtered list
List the tasks matching what you care about, close them as they are done, and reopen the one you closed by mistake.
03
Restructuring a project
Create and rename the sections, move the shape around, and check who is collaborating on it.
04
Leaving context on a task
Comment on it so the reasoning lives with the work, and read back what was said before acting on it.
27 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_label
Create a label
add_project
Create a new Todoist project
add_section
Create a new section in a Todoist project
add_task
Create a TODO task
close_task
Close a TODO task
delete_comment
Delete a comment
delete_label
Delete a label
delete_project
Delete a Todoist project
delete_section
Delete a Todoist section
delete_task
Delete a TODO task
get_comment
Get a comment
get_label
Get a label
get_project
Get details of a Todoist project
get_project_collaborators
Get collaborators for a Todoist project
get_section
Get details of a Todoist section
get_task
Get a TODO task
list_comments
List and filter comments
list_labels
List and filter labels
list_projects
List all Todoist projects
list_sections
List all sections in a Todoist project
list_tasks
List and filter TODO tasks
reopen_task
Reopen a TODO task
update_comment
Update a comment
update_project
Update an existing Todoist project
update_section
Update an existing Todoist section
update_task
Update a TODO task
BEFORE YOU INSTALL
What to know first
Tools you get
27 tools when we connected.
Requires
- npx on PATH
- TODOIST_API_TOKEN in your environment
Where it runs
Both documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 27 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @ganiev/todoist-mcp-serverMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": [
"-y",
"@ganiev/todoist-mcp-server"
],
"env": {
"TODOIST_API_TOKEN": "<YOUR_TODOIST_API_TOKEN>"
}
}
}
}Claude Desktop — Docker
CLAUDE DESKTOP — DOCKER · JSON
{
"mcpServers": {
"todoist": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TODOIST_API_TOKEN=<YOUR_TODOIST_API_TOKEN>",
"ghcr.io/ganievs/todoist-mcp-server:latest"
]
}
}
}
