Connect Todoist’s MCP (Model Context Protocol) server to Claude Code and manage your tasks directly from your terminal. Once connected, you can create, read, and update Todoist tasks and projects without ever leaving your coding environment – great for staying in flow while tracking work.
You can also connect Todoist to Claude via the Todoist connector in Claude for a chat-first workflow. Once connected, Claude can read, create, and update your Todoist tasks and projects. See the Use Todoist with Claude for the instructions.
Check the requirements
- A paid Claude plan – Pro, Max, Team, Enterprise, or Console. The free Claude.ai plan doesn’t include Claude Code access.
- Claude Code installed and authenticated on your machine.
- You’ll be signing in with OAuth, which authorizes Claude Code to access Todoist through the official Todoist MCP server.
Set up Todoist MCP in Claude Code
1. Add the Todoist MCP server
Open your terminal and run the following command:
claude mcp add --transport http todoist https://ai.todoist.net/mcp2. Confirm the server was added
Once the command completes, you’ll see the following response appear in your terminal:
1 MCP server needs auth · /mcpThis confirms that the Todoist MCP server has been added and is waiting for you to authorize it.
3. Open the MCP server list
In the same terminal, type /mcp and press Enter. This opens a list of all your installed MCP servers, including the newly added Todoist one.
4. Select the Todoist server
Use the ↑ and ↓ arrow keys to navigate to Todoist in the list, then press Enter.
5. Complete the authorization flow
Follow the on-screen prompts to log in to your Todoist account and grant Claude Code the necessary permissions.
Once authorized, Todoist is ready to use in Claude Code.
What Claude Code will have access to
Once connected, Claude Code can use the Todoist MCP server to:
- Read your Todoist tasks and projects
- Create tasks and projects
- Update tasks and projects (for example: rename, reschedule, or move 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 through MCP, your task data is shared with both Todoist’s servers and Claude. Data handling on Todoist’s side is governed by Todoist’s privacy policy; data that enters Claude’s context (your tasks, projects, and so on) is also subject to Anthropic’s privacy policy.
For extra peace of mind, review what permissions you've granted at any time by visiting Todoist’s Settings > Integrations.
Disconnect Todoist MCP
You can disconnect from two places:
-
In Claude Code: run
claude mcp remove todoistin your terminal to remove the server. - In Todoist: revoke access from Settings > Integrations to revoke Claude Code’s access.
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
Try running the Claude Code command again. If the window still doesn’t appear, check that your browser isn’t blocking pop-ups and 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 one won’t pick up new connections.
Report a bug or request a feature
The Todoist MCP server is open source. You can report bugs, request features, or browse known issues in the official Todoist AI repository on GitHub.
Get in touch
If you have questions about connecting Todoist MCP to Claude Code or want to learn more, get in touch with us.