KosmoKrator

productivity

Todoist MCP, CLI, and Lua Integration for AI Agents

Todoist integration docs for AI agents: MCP gateway setup, Todoist CLI commands, Lua API reference, credentials, and function schemas.

Todoist for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Todoist CLIHeadless setup, JSON output, direct function calls. Todoist MCPExpose selected tools to local MCP clients. Todoist LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug
todoist
route_slug
todoist
package
todoist
auth_strategy
bearer_token
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true

Function Catalog

FunctionTypeParametersDescription
todoist.todoist_close_task Write write 1 Mark a task as completed (close it). The task will move to the completed view.
todoist.todoist_create_comment Write write 3 Add a comment to a Todoist task or project. Provide either task_id or project_id along with the content.
todoist.todoist_create_project Write write 5 Create a new project in Todoist. Projects can be nested using parent_id.
todoist.todoist_create_section Write write 3 Create a new section within a Todoist project to organize tasks into groups.
todoist.todoist_create_task Write write 12 Create a new task in Todoist.
todoist.todoist_delete_project Write write 1 Permanently delete a project and all its tasks from Todoist. This action cannot be undone.
todoist.todoist_delete_section Write write 1 Permanently delete a section from Todoist. This action cannot be undone.
todoist.todoist_delete_task Write write 1 Permanently delete a task from Todoist. This action cannot be undone.
todoist.todoist_get_current_user Read read 0 Get the currently authenticated Todoist user.
todoist.todoist_get_project Read read 1 Get detailed information about a Todoist project.
todoist.todoist_get_section Read read 1 Retrieve a single Todoist section by its ID.
todoist.todoist_get_task Read read 1 Get detailed information about a Todoist task.
todoist.todoist_list_comments Read read 2 List comments for a Todoist task or project. Provide either task_id or project_id.
todoist.todoist_list_labels Read read 0 List all personal labels in Todoist.
todoist.todoist_list_projects Read read 1 List all projects in Todoist.
todoist.todoist_list_sections Read read 1 List all sections, optionally filtered by a specific project ID.
todoist.todoist_list_tasks Read read 6 List tasks in Todoist with optional filters.
todoist.todoist_quick_add Write write 4 Add a task using Todoist's natural language quick-add. Examples: "Buy milk tomorrow", "Meeting with team every Monday @Work p1".
todoist.todoist_reopen_task Write write 1 Reopen a completed task, returning it to the active task list.
todoist.todoist_update_project Write write 5 Update an existing project in Todoist. Only the fields provided will be changed.
todoist.todoist_update_task Write write 6 Update an existing task in Todoist. Only the fields provided will be changed.