---
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 ↓](#setup)[Original source ↗](https://github.com/Doist/todoist-mcp)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 10 linked sources
 Publisher Doist
 Licence [MIT ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/LICENSE)
 Revision a5b60137cfd1
 [Read what was—and wasn’t—checked ↓](#review)

“Library for connecting AI agents to Todoist.”

 [Doist · upstream description ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/README.md) 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 at a5b60137cfd129763924092196e679342bf6ec90: hosted OAuth, local stdio/HTTP setup and access boundaries.
- package.json, src/main.ts, src/main-http.ts and src/http-app.ts at a5b60137cfd129763924092196e679342bf6ec90: executables, account authority and transport handling.
- src/mcp-server.ts and src/tools/delete-object.ts at a5b60137cfd129763924092196e679342bf6ec90: instructions, registration and destructive operations.
- LICENSE at a5b60137cfd129763924092196e679342bf6ec90: MIT source terms.
- src/tool-registry.ts and src/mcp-helpers.ts at a5b60137cfd129763924092196e679342bf6ec90: 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.
- src/tool-registry.ts registers 47 tools at this commit, including add, update and find tools for tasks, projects, sections, comments, reminders, labels and filters; complete, uncomplete and reschedule for tasks; a single delete-object tool; and project-template import and export.
- Between the previous pin and this commit the package moved from 13.3.1 to 13.4.1 (still @doist/todoist-mcp, MIT, Node.js 24 or later); README, docs/mcp-server.md and the inspected source files are unchanged.

### 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 ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/README.md)

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 24 or later, npm 11 or later (package.json 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 ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/README.md) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/README.md Supports: upstreamDescription, descriptionSourceUrl, summary, whySelected, bestFor, compatibility, configExample, install, transports
- [Local server setup and authority ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/docs/mcp-server.md) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/docs/mcp-server.md Supports: install, compatibility, limitations, access, transports, review
- [Package manifest ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/package.json) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/package.json Supports: language, install.prerequisites
- [Server instructions and tool registration ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/mcp-server.ts) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/mcp-server.ts Supports: review, summary, bestFor, limitations
- [Destructive object deletion ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/tools/delete-object.ts) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/tools/delete-object.ts Supports: review, access, limitations
- [Local HTTP request handling ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/http-app.ts) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/http-app.ts Supports: review, access, limitations, transports
- [Todoist plans ↗](https://www.todoist.com/pricing) Checked 2026-10-13 https://www.todoist.com/pricing Supports: access.cost
- [Repository licence ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/LICENSE) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/LICENSE Supports: license
- [Tool registration list ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/tool-registry.ts) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/tool-registry.ts Supports: review, limitations, access
- [Tool feature and execution wrapper ↗](https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/src/mcp-helpers.ts) Checked 2026-10-13 https://github.com/Doist/todoist-mcp/blob/a5b60137cfd129763924092196e679342bf6ec90/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/)[### Airtable MCP Server ↗ Hosted Airtable server exposing bases, records, tables, interfaces and automations as tools over Streamable HTTP. Every connection is scoped to authorised bases and the server enforces existing Airtable permissions, so a read-only base stays read-only through MCP.](/mcp-servers/airtable/)[### Algolia MCP Server ↗ Algolia's managed MCP offerings: Public MCP exposes application-scoped search and recommendations on selected indices for customer-facing agents; Productivity MCP gives user-scoped, read-only exploration and analytics; DevEx MCP serves version-matched API client snippets to coding agents without touching data.](/mcp-servers/algolia/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
