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.
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.
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@doistThe 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/mcpThen open Claude Code, run /mcp, select Todoist from the list, and complete the OAuth flow in your browser.
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.
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 todoistin 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.