home / mcp / todoist mcp server

Todoist MCP Server

Provides Todoist API integration with MCP to manage tasks, projects, sections, comments, and labels through structured commands.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "devongroff-todoist-mcp": {
      "command": "node",
      "args": [
        "/path/to/todoist-mcp/dist/index.js"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token"
      }
    }
  }
}

You can run Todoist MCP Server to integrate the Todoist REST API v2 with your AI assistants, enabling task, project, section, comment, and label management through a consistent MCP interface. It supports task actions, batch operations, progress history, and rate-limited handling to fit Todoist’s API limits.”

How to use

This MCP server exposes a set of operations that you can call from an MCP client to manage Todoist resources. You will run the server locally and point your MCP client to it. Use the provided tools to create, read, update, delete, and organize tasks, projects, sections, comments, and labels. You can also access completed task history through the synchronization flow and rely on built‑in rate limiting with exponential backoff to stay within Todoist’s limits.

How to install

npm install
npm run build

Configuration and usage notes

To run Todoist MCP Server locally, you configure the MCP client to connect to the server using a stdio-based setup. The server requires your Todoist API token to authorize requests. Ensure you never commit this token to version control and keep it secure in your local MCP configuration.

{
  "mcpServers": {
    "todoist": {
      "command": "node",
      "args": ["/path/to/todoist-mcp/dist/index.js"],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token"
      }
    }
  }
}

Additional content

The server provides a complete set of operations for task, project, section, comment, and label management, including batch task creation and access to completed task history via the Sync API. The included tools are designed to cover common Todoist workflows, with some helpers for prefixed comments, such as [Research], [Context], and [Prompt] in notes.

Available tools

todoist_list_tasks

List active tasks with optional filters to refine results.

todoist_get_task

Retrieve a single task by its identifier.

todoist_create_task

Create a new task with specified content, due date, labels, and other properties.

todoist_update_task

Update properties of an existing task.

todoist_complete_task

Mark a task as completed.

todoist_reopen_task

Reopen a completed task.

todoist_delete_task

Delete a task.

todoist_move_task

Move a task to a different project or section.

todoist_search_tasks

Search tasks by content or filters.

todoist_create_tasks_batch

Create multiple tasks in a single operation.

todoist_list_projects

List all projects.

todoist_get_project

Get a specific project by identifier.

todoist_create_project

Create a new project.

todoist_update_project

Update properties of an existing project.

todoist_delete_project

Delete a project.

todoist_list_sections

List all sections within projects.

todoist_get_section

Get a specific section.

todoist_create_section

Create a new section within a project.

todoist_update_section

Update a section.

todoist_delete_section

Delete a section.

todoist_list_comments

List comments for a task or project.

todoist_get_comment

Get a specific comment.

todoist_create_comment

Create a comment with optional prefix such as [Research], [Context], or [Prompt].

todoist_update_comment

Update a comment.

todoist_delete_comment

Delete a comment.

todoist_add_research_comment

Add a [Research] prefixed comment.

todoist_add_context_comment

Add a [Context] prefixed comment.

todoist_list_labels

List all labels.

todoist_create_label

Create a new label.

todoist_update_label

Update a label.

todoist_delete_label

Delete a label.

todoist_list_completed_tasks

List completed tasks from history.

todoist_get_completed_stats

Get completion statistics.