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.

21 functions 9 read 12 write Bearer token auth
Submit Todoist feedback View package source

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.

Machine-Readable Metadata
integration_slug
todoist
route_slug
todoist
package
todoist
auth_strategy
bearer_token Bearer token
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true
supports_multi_account
true

Quick Links

Lua APIAgent-facing namespace and function reference. Todoist CLIHeadless setup and direct function calls. Todoist MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Todoist MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Todoist.

Claude Code Todoist MCP setup for Claude Code. Cursor Todoist MCP setup for Cursor. Codex Todoist MCP setup for Codex. OpenAI Agents Todoist MCP setup for OpenAI Agents SDK. Claude Agent SDK Todoist MCP setup for Claude Agent SDK. Vercel AI SDK Todoist MCP setup for Vercel AI SDK. LangChain Todoist MCP setup for LangChain. LangGraph Todoist MCP setup for LangGraph. CrewAI Todoist MCP setup for CrewAI. MCP clients Todoist MCP setup for Generic MCP Clients.

Todoist CLI Matrix

Use these pages for direct Todoist CLI workflows in scripts, CI, cron, and agent wrappers.

CI Todoist CLI for CI. Cron Jobs Todoist CLI for cron jobs. Shell Scripts Todoist CLI for shell scripts. Headless Automation Todoist CLI for headless automation. Coding Agents Todoist CLI for coding agents.

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.