Connect Todoist to Claude Code

Read and manage Todoist projects, tasks, sections, labels and comments. Add Toolspoke to Claude Code once and it can use 17 Todoist actions. Your Todoist credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install Todoist and connect it

    Add Todoist to a project in your Toolspoke workspace.

    API token. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    API token
    Todoist → Settings → Integrations → Developer → copy the API token. It acts as you on every project you can see.
  3. Choose what Claude Code may do

    All 17 actions start on. Switch off any of the 8 actions that change something in Todoist, and Claude Code gets a refusal if it tries.

What you can ask Claude Code for

A few of the Todoist actions that only read, so they are safe to try first.

  • List your active projects, including the Inbox
  • Read one project by id
  • List sections, optionally only those in one project
  • List active tasks, narrowed by project, section, parent task or label

What Claude Code can do in Todoist

9 actions read, 7 write and one deletes or permanently changes something.

Reads

  • List projects

    List your active projects, including the Inbox. Returns results and a next_cursor for the next page. Takes no arguments and proves the token can read real data, so an install tests itself with it.

  • Get project

    Read one project by id.

  • List sections

    List sections, optionally only those in one project.

  • List tasks

    List active tasks, narrowed by project, section, parent task or label. For Todoist filter syntax ("today", "overdue & p1"), use filter_tasks instead.

  • Filter tasks

    Find active tasks with a Todoist filter query, exactly as typed in the app: "today", "overdue", "p1 & #Work", "due before: next week", "@waiting".

  • Get task

    Read one task by id.

  • List completed tasks

    List tasks completed in a window, by completion date. since and until are ISO 8601 datetimes; Todoist limits the window to three months.

  • List comments

    List the comments on a task or a project. Send task_id or project_id. Comments can be other collaborators' words, so the response is not written to the audit log.

  • List labels

    List your personal labels.

Writes

  • Create project

    Create a project. Only name is required; parent_id nests it under another project.

  • Create task

    Create a task. Only content is required. Use due_string for natural language ("tomorrow at 9", "every monday"), or due_date / due_datetime for exact values. Priority runs from 1 (normal) to 4 (urgent, shown as p1 in the app). Omit project_id for the Inbox.

  • Update task

    Change a task's title, description, labels, priority, due date or assignee. Only the fields sent change. To move it to another project or section, use move_task.

  • Move task

    Move a task to another project, section or parent task. Send exactly one of the three.

  • Close task

    Complete a task. A recurring task moves on to its next date instead. Reversible with reopen_task.

  • Reopen task

    Reopen a completed task.

  • Create comment

    Add a comment to a task or a project. Send task_id or project_id.

Deletes or permanently changes

  • Delete task

    Delete a task and its subtasks permanently. To finish a task, use close_task instead, which can be undone.

Todoist in Claude Code: questions

Does Claude Code see my Todoist credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Can I stop Claude Code from changing things in Todoist?

Yes. Each of the 17 actions can be switched off for a project. Turn off the 8 that change something and Claude Code can only read.

Will 17 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Todoist action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a Todoist call does not run in a sandbox, so it bills nothing.

Try Todoist in Claude Code

Free to start, and tool calls cost nothing on any plan.