mcp-todoist MCP Server

An MCP (Model Context Protocol) server that connects Claude with Todoist for complete task and project management through natural language.

Local serverstdioMIT

What is the mcp-todoist MCP Server?

mcp-todoist is an MCP project maintained in the greirson/mcp-todoist repository. The maintainer describes its purpose as “An MCP (Model Context Protocol) server that connects Claude with Todoist for complete task and project management through natural language”. Read the project documentation for the complete scope.

Installation

The documented npm package is @greirson/mcp-todoist. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares TODOIST_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
todoist_taskcreate, get, update, delete, complete, reopen, quick_add
todoist_task_bulkbulk_create, bulk_update, bulk_delete, bulk_complete
todoist_subtaskcreate, bulk_create, convert, promote, hierarchy
todoist_projectcreate, get, update, delete, archive, collaborators
todoist_project_opsreorder, move_to_parent, get_archived
todoist_sectioncreate, get, update, delete, move, reorder, archive
todoist_labelcreate, get, update, delete, stats
todoist_commentcreate, get, update, delete
todoist_remindercreate, get, update, delete
todoist_filtercreate, get, update, delete
todoist_collaborationinvitations, notifications, workspace operations
todoist_userinfo, productivity_stats, karma_history
todoist_utilitytest_connection, test_features, test_performance, find/merge duplicates
todoist_activityget_log, get_events, get_summary
todoist_task_opsmove, reorder, close
todoist_completedget, get_all, get_stats
todoist_backuplist, download
todoist_notescreate, get, update, delete
todoist_shared_labelscreate, get, rename, remove

How to install the mcp-todoist MCP Server

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "@greirson/mcp-todoist"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_TODOIST_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TODOIST_API_TOKENDeclared in the maintainer’s client configuration.Check documentation