KosmoKrator

productivity

Todoist MCP Integration for OpenAI Agents SDK

Connect Todoist to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

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

Connect Todoist to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Todoist MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-todoist": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=todoist",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=todoist --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Todoist instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Todoist Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Todoist integration catalog.

MCP toolSource functionTypeDescription
integration__todoist__todoist_close_task todoist.todoist_close_task Write Mark a task as completed (close it). The task will move to the completed view.
integration__todoist__todoist_create_comment todoist.todoist_create_comment Write Add a comment to a Todoist task or project. Provide either task_id or project_id along with the content.
integration__todoist__todoist_create_project todoist.todoist_create_project Write Create a new project in Todoist. Projects can be nested using parent_id.
integration__todoist__todoist_create_section todoist.todoist_create_section Write Create a new section within a Todoist project to organize tasks into groups.
integration__todoist__todoist_create_task todoist.todoist_create_task Write Create a new task in Todoist.
integration__todoist__todoist_delete_project todoist.todoist_delete_project Write Permanently delete a project and all its tasks from Todoist. This action cannot be undone.
integration__todoist__todoist_delete_section todoist.todoist_delete_section Write Permanently delete a section from Todoist. This action cannot be undone.
integration__todoist__todoist_delete_task todoist.todoist_delete_task Write Permanently delete a task from Todoist. This action cannot be undone.
integration__todoist__todoist_get_current_user todoist.todoist_get_current_user Read Get the currently authenticated Todoist user.
integration__todoist__todoist_get_project todoist.todoist_get_project Read Get detailed information about a Todoist project.
integration__todoist__todoist_get_section todoist.todoist_get_section Read Retrieve a single Todoist section by its ID.
integration__todoist__todoist_get_task todoist.todoist_get_task Read Get detailed information about a Todoist task.
integration__todoist__todoist_list_comments todoist.todoist_list_comments Read List comments for a Todoist task or project. Provide either task_id or project_id.
integration__todoist__todoist_list_labels todoist.todoist_list_labels Read List all personal labels in Todoist.
integration__todoist__todoist_list_projects todoist.todoist_list_projects Read List all projects in Todoist.
integration__todoist__todoist_list_sections todoist.todoist_list_sections Read List all sections, optionally filtered by a specific project ID.
integration__todoist__todoist_list_tasks todoist.todoist_list_tasks Read List tasks in Todoist with optional filters.
integration__todoist__todoist_quick_add todoist.todoist_quick_add Write Add a task using Todoist's natural language quick-add. Examples: "Buy milk tomorrow", "Meeting with team every Monday @Work p1".
integration__todoist__todoist_reopen_task todoist.todoist_reopen_task Write Reopen a completed task, returning it to the active task list.
integration__todoist__todoist_update_project todoist.todoist_update_project Write Update an existing project in Todoist. Only the fields provided will be changed.
integration__todoist__todoist_update_task todoist.todoist_update_task Write Update an existing task in Todoist. Only the fields provided will be changed.

Related Todoist Pages

Todoist CLIUse direct JSON commands instead of MCP discovery. Todoist MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.