Todoist MCP server for AI agents

Manage Todoist tasks, projects, sections and comments.

Auth
Access token
Tools
12
Triggers
0
Category
Productivity

Tools and triggers

  • List projects

    TODOIST_LIST_PROJECTS

    Lists all of the user's projects with their ids.read-only

  • Create a project

    TODOIST_CREATE_PROJECT

    Creates a project, optionally inside another project.

  • List active tasks

    TODOIST_LIST_TASKS

    Lists active tasks, optionally in one project, section or label, or matching a Todoist filter such as `today | overdue`.read-only

  • Get a task

    TODOIST_GET_TASK

    Returns one active task with its content, due date, priority and labels.read-only

  • Create a task

    TODOIST_CREATE_TASK

    Adds a task. Goes to the Inbox unless `project_id` is given. Priority 4 is the most urgent.

  • Update a task

    TODOIST_UPDATE_TASK

    Changes a task's title, description, labels, priority or due date. Fields left out stay as they are.destructive

  • Complete a task

    TODOIST_CLOSE_TASK

    Marks a task as done. A recurring task moves to its next due date.

  • Reopen a task

    TODOIST_REOPEN_TASK

    Marks a completed task as not done again.

  • Delete a task

    TODOIST_DELETE_TASK

    Permanently deletes a task.destructive

  • List sections

    TODOIST_LIST_SECTIONS

    Lists the sections of a project, or of all projects when `project_id` is left out.read-only

  • Add a comment

    TODOIST_ADD_COMMENT

    Comments on a task, or on a project when `project_id` is given instead of `task_id`.

  • List comments

    TODOIST_LIST_COMMENTS

    Lists the comments on a task or a project. Give one of `task_id` or `project_id`.read-only

Connect via MCP

Create an MCP server for Todoist in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.

terminal
claude mcp add --transport http todoist \
  "https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
  --header "x-api-key: ptm_…"

Connect via REST

Run a tool with one request. The response is { data, error, successful, log_id } for every tool.

terminal
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/TODOIST_LIST_PROJECTS \
  -H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
  -d '{ "user_id": "alice", "arguments": {} }'

Todoist questions