Todoist MCP Server

MCP server for Todoist task management integration

Local serverstdioTypeScript

What is the Todoist MCP server?

If you already use Todoist, the todoist mcp server is the piece that lets your assistant work with it directly. MCP server for Todoist task management integration.

What the server does

A Model Context Protocol (MCP) server for Todoist task management, enabling Claude to interact with your Todoist tasks and projects.

  • ✅ Create, read, update, and complete tasks
  • 📋 List tasks with advanced filtering
  • 🔍 Search tasks by text content
  • 📁 Manage projects
  • 🏷️ Support for labels and priorities
  • 📅 Natural language date parsing

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Prerequisites — The Prerequisites tool exposed by this server
  • todoist_create_task — Create a new task in Todoist with optional project, due date, priority, labels, and parent task for subtasks
  • todoist_list_tasks — List active tasks with optional filters for project, section, label, or custom Todoist filter
  • todoist_get_task — Get detailed information about a specific task including all metadata
  • todoist_update_task — Update an existing task with new content, description, due date, priority, or labels
  • todoist_complete_task — The todoist_complete_task tool exposed by this server
  • todoist_list_projects — List all projects in Todoist, including inbox and shared projects
  • todoist_search_tasks — The todoist_search_tasks tool exposed by this server
  • Build — The Build tool exposed by this server

Credentials and setup notes

Configuration is passed through the environment: TODOIST_API_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • Node.js >= 18.0.0 - npm or yarn - A Todoist account with an API token

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

Where it fits

This sits in the planning and project tracking group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Todoist's toolset — Prerequisites, todoist_create_task, todoist_list_tasks and 6 more — is a fair guide to whether it matches your workflow. It is maintained by ecfaria; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Todoist's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Todoist.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
todoist_create_taskCreate a new task in Todoist with optional project, due date, priority, labels, and parent task for subtasks.
todoist_list_tasksList active tasks with optional filters for project, section, label, or custom Todoist filter.
todoist_get_taskGet detailed information about a specific task including all metadata.
todoist_update_taskUpdate an existing task with new content, description, due date, priority, or labels.
todoist_complete_taskThe todoist_complete_task tool exposed by this server.
todoist_list_projectsList all projects in Todoist, including inbox and shared projects.
todoist_search_tasksThe todoist_search_tasks tool exposed by this server.
BuildThe Build tool exposed by this server.

Configuration

  • Node.js >= 18.0.0 - npm or yarn - A Todoist account with an API token
VariableDescriptionRequired
TODOIST_API_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Todoist to Prerequisites.
  • Use Todoist to todoist create task.
  • Use Todoist to todoist list tasks.

Frequently asked questions

It connects Todoist to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (Prerequisites, todoist_create_task, todoist_list_tasks, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Todoist directly.