TASK PLANNING / Doist
Todoist MCP
Reads and changes Todoist tasks, projects and schedules through Doist’s hosted service or local server.
“Library for connecting AI agents to Todoist.”
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.
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.
DOCUMENTED COMMAND
claude mcp add --transport http todoist https://ai.todoist.net/mcpCopying 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"
}
}
}04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/README.md
Supports: upstreamDescription, descriptionSourceUrl, summary, whySelected, bestFor, compatibility, configExample, install, transports
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/docs/mcp-server.md
Supports: install, compatibility, limitations, access, transports, review
- Package manifest ↗Checked
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/package.json
Supports: language, install.prerequisites
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/mcp-server.ts
Supports: review, summary, bestFor, limitations
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/tools/delete-object.ts
Supports: review, access, limitations
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/http-app.ts
Supports: review, access, limitations, transports
- Todoist plans ↗Checked
https://www.todoist.com/pricing
Supports: access.cost
- Repository licence ↗Checked
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/LICENSE
Supports: license
- Tool registration list ↗Checked
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/tool-registry.ts
Supports: review, limitations, access
https://github.com/Doist/todoist-mcp/blob/d3129453f15cef4618bc68bec73cf974c4bf3648/src/mcp-helpers.ts
Supports: review, limitations, access