--- title: "Todoist MCP: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/mcp-servers/todoist/ description: "Reads and changes Todoist tasks, projects and schedules through Doist’s hosted service or local server." --- # Todoist MCP: review, setup & limitations · Undominated.ai > Reads and changes Todoist tasks, projects and schedules through Doist’s hosted service or local server. [← Explore all mcp servers](/mcp-servers/) TASK PLANNING / Doist # Todoist MCP Reads and changes Todoist tasks, projects and schedules through Doist’s hosted service or local server. See setup guidance ↓Original source ↗ SOURCE REVIEW Reviewed 2026-09-21 Evidence 10 linked sources Publisher Doist Licence MIT ↗ Revision d3129453f15c Read what was—and wasn’t—checked ↓ “Library for connecting AI agents to Todoist.” Doist · upstream description ↗ Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - Adds personal and team task planning, including due dates and rescheduling, beyond software issue tracking. - The publisher documents both hosted OAuth setup and a local API-key process, with source-visible mutation behavior. ### A good fit for - Reviewing upcoming work and rescheduling tasks in an existing Todoist account. - Turning an agreed plan into tasks, projects and assignments. ### Weigh up before choosing - The toolset can create, update, complete and delete account data. Deletion hints inform a client but are not a human approval gate. - The standalone HTTP service runs tools as the operator’s configured account; its trusted-host checks do not make it a public multi-user service. - Some operations have irreversible or partial effects: the server instructions warn about immediate template imports and partially successful batches. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - README.md and docs/mcp-server.md: hosted OAuth, local stdio/HTTP setup and access boundaries. - package.json, src/main.ts, src/main-http.ts and src/http-app.ts: executables, account authority and transport handling. - src/mcp-server.ts and src/tools/delete-object.ts: instructions, registration and destructive operations. - LICENSE: MIT source terms. - src/tool-registry.ts and src/mcp-helpers.ts: default registration and execution wrapper. ### Our findings - The stdio entrypoint requires TODOIST_API_KEY and creates the server for that account. - The delete-object tool directly calls deletion APIs; workspace projects must first be archived, while personal projects may be deleted directly. - Server instructions distinguish rescheduling from replacing a due string, because replacement can remove recurrence. ### Not established by this review - Account authentication, recurrence handling, deletion, shared-workspace behavior and client compatibility were not executed. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Connect a server deliberately. Upstream setup instructions ↗ DOCUMENTED COMMAND claude mcp add --transport http todoist https://ai.todoist.net/mcp Copy command ↗ Copying does not execute this command. It may retrieve a newer version than the reviewed source. - The command configures the hosted server in Claude Code; open /mcp afterward and authenticate with Todoist. - For VS Code use the documented servers configuration shown here; other clients need their own setup format. - For local stdio, set TODOIST_API_KEY securely and use the documented npx @doist/todoist-mcp entrypoint. ### Before you start - A Todoist account and the chosen MCP client. - For the local alternative, Node.js and npm satisfying the current package engines and a Todoist API key. ### Documented configuration example Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts. { "servers": { "todoist": { "type": "http", "url": "https://ai.todoist.net/mcp" } } } Copy configuration ↗ ### Compatibility Hosted Streamable HTTP clients with Todoist OAuth; the configuration below is the documented VS Code schema. · Local stdio clients with Node.js, npm and a Todoist API key. ### Implementation TypeScript ### Transports stdio · Streamable HTTP ### Todoist account / OAuth or API key - Reads task, project and collaboration data visible to the authenticated account. - Can change schedules, assignments, comments and projects, including destructive deletion. ### Cost model Todoist account plans determine available service features; connecting MCP does not replace the Todoist subscription or your assistant’s plan. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - Official setup and hosted endpoint ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/README.md Supports: upstreamDescription, descriptionSourceUrl, summary, whySelected, bestFor, compatibility, configExample, install, transports - Local server setup and authority ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/docs/mcp-server.md Supports: install, compatibility, limitations, access, transports, review - Package manifest ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/package.json Supports: language, install.prerequisites - Server instructions and tool registration ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/mcp-server.ts Supports: review, summary, bestFor, limitations - Destructive object deletion ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/tools/delete-object.ts Supports: review, access, limitations - Local HTTP request handling ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/http-app.ts Supports: review, access, limitations, transports - Todoist plans ↗ Checked 2026-09-21 https://www.todoist.com/pricing Supports: access.cost - Repository licence ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/LICENSE Supports: license - Tool registration list ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/tool-registry.ts Supports: review, limitations, access - Tool feature and execution wrapper ↗ Checked 2026-09-21 https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/mcp-helpers.ts Supports: review, limitations, access KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Asana MCP V2 ↗ Asana’s current workspace-scoped MCP connection for task, project and portfolio workflows.](/mcp-servers/asana/)[### Canva MCP ↗ A hosted connection for authorized Canva design discovery, creation, editing and export workflows.](/mcp-servers/canva/)[### GitHub MCP Server ↗ Connects an assistant to repository, issue, pull-request and workflow operations with selectable toolsets and account permissions.](/mcp-servers/github/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)