Use Todoist in Claude Code

Connect Todoist to Claude Code and manage your tasks while you work. Once connected, Claude Code can create, read, and update your Todoist tasks and projects. There are two ways to connect Todoist in Claude Code: the Todoist CLI or the Todoist MCP (Model Context Protocol) server.

Note

You can also connect Todoist to Claude through the Todoist connector (the recommended path), which works without setting up Claude Code. See Use Todoist in Claude.

Before you start

You'll need:

Claude Code installed and authenticated on your machine.
A paid Claude plan: Pro, Max, Team, or Enterprise, or API access through the Console. The free Claude.ai plan doesn't include Claude Code.
Node.js and npm, for the CLI method.
A Todoist account to sign in to.

Set up the Todoist CLI

The Todoist CLI lets Claude Code manage your tasks by running td commands right in your terminal.

Install and connect

Install the CLI.
```
npm install -g @doist/todoist-cli
```
Install the Claude Code skill so Claude Code knows how to use the CLI.
```
td skill install claude-code
```
Authenticate with Todoist.
```
td auth login
```

td auth login opens your browser to sign in with OAuth, then stores your token in your operating system's credential manager (Keychain on macOS, Credential Manager on Windows, Secret Service on Linux). Once connected, ask Claude Code in plain language and it runs the right td commands for you.

Using a different coding agent? The Todoist CLI also installs skills for Codex, Copilot, Cursor, Gemini, and more. See the Todoist CLI repo for the full setup.

Quick tip

Want Claude Code to read your tasks but never change them? Run td auth login --read-only instead. In read-only mode, any command that would create, update, or delete data is blocked.

Set up Todoist MCP in Claude Code

You can connect through the Model Context Protocol server instead of the CLI. Once connected, you can create, read, and update Todoist tasks and projects without leaving your coding environment. There are two ways to add it: use the Todoist plugin, or add the server manually.

Connect with the Todoist plugin

In Claude Code, run these two commands:

/plugin marketplace add doist/todoist-mcp
/plugin install todoist@doist

The first time you use a Todoist tool, Claude Code opens your browser so you can sign in with OAuth. Once you've approved access, there's nothing else to set up.

Connect manually

If you prefer to add the server yourself, run this command in your terminal:

claude mcp add --transport http todoist https://ai.todoist.net/mcp

Then open Claude Code, run /mcp, select Todoist from the list, and complete the OAuth flow in your browser.

Warning

Add the server only once. Running claude mcp add again creates a duplicate entry, which can cause sign-in loops. Run /mcp first to check whether Todoist is already connected.

What Claude Code can access

Once connected through either the CLI or MCP, Claude Code can:

Read your Todoist tasks and projects.
Create tasks and projects.
Update tasks and projects, for example rename, reschedule, or move them to a different project.

Warning

Because this connection supports write actions, Claude Code can make changes to your Todoist data when you instruct it to. Review any changes before confirming them.

Examples of what you can do

Here are a few prompts that work well once you're connected:

Category	Example prompts
Capture tasks from your code	Add a task to Todoist: 'Fix the auth bug in login.js' and put it in the Engineering project. Create a task for 'Write unit tests for the payment module' and set it due this Friday.
Plan your work	List all my overdue Todoist tasks and help me decide what to tackle today. Show me everything due this week and suggest what I can realistically finish.
Triage your inbox	Go through my Todoist Inbox and turn each item into a clear, actionable next step. Move any tasks tagged 'waiting' into a 'Waiting for' section and add a follow-up task for next Monday.
Stay in flow	I'm working on the checkout feature, check Todoist and tell me if there are any related open tasks. Add a task for every TODO comment in this file and put them all in the current sprint project.

Privacy and data handling

When you connect Todoist to Claude Code, your task data is shared with both Todoist's servers and Claude, whether you use the CLI or the MCP server. Data handling on Todoist's side is governed by Todoist's privacy policy. Data that enters Claude's context, such as your tasks and projects, is also subject to Anthropic's privacy policy.

To review what you've granted access to at any time, go to Todoist's Settings > Integrations.

Disconnect Todoist from Claude Code

If you connected with the CLI, run td auth logout to remove the saved token, then revoke access from Todoist's Settings > Integrations.

If you connected with the MCP server, disconnect from both places:

Run claude mcp remove todoist in your terminal to remove the server.
Revoke Claude Code's access from Todoist's Settings > Integrations.

Tips for best results

A few habits will help you get the most out of Todoist in Claude Code:

Batch tasks when adding several at once

The Todoist MCP supports up to 25 tasks per call. Tell Claude to add them all together: "Add all of these in a single call." Creating them one by one can exhaust Claude's tool-call limit before your list is complete.

Use "reschedule" for recurring tasks

To move a recurring task to a new date, say "reschedule this task to [date]" rather than "change the date." The reschedule tool keeps the recurrence pattern; changing the date doesn't. If a task has already lost its recurrence, set it again in the task's date field.

Create team-folder projects first, then move them

The Todoist MCP can't place a new project inside a workspace folder when it's created. Ask Claude to create the project, then drag it into the right folder in Todoist.

Check your connection before opening a new session

If Claude stops responding to Todoist requests mid-conversation, run /mcp to check whether the connection is still active. Reconnecting from there is faster than starting a new session.

Troubleshooting

The `claude mcp add` command isn't recognized

Make sure Claude Code is installed and up to date. See the Claude Code documentation for installation instructions.

The OAuth browser window doesn't open

Run the Claude Code command again. If the window still doesn't appear, check that your browser isn't blocking pop-ups, then retry.

The server shows in `claude mcp list` but Todoist tools aren't available

Start a new Claude Code session after adding the server. MCP servers only load at session start, so an existing session won't pick up a new connection.

"No transport found for sessionId" error

Go to Todoist Settings > Integrations and remove all Claude Code entries. Then run /mcp in Claude Code, select Todoist, and sign in again.

Report a bug or request a feature

The Todoist CLI and MCP server are both open source. Report bugs, request features, or browse known issues in the Todoist CLI repository or the Todoist MCP repository on GitHub.

Get in touch

If you have questions about connecting Todoist to Claude Code or want to learn more, get in touch with us.