Todoist MCP Server Extended

🚀 Todoist MCP Server Extended

This is an implementation of the MCP (Model Context Protocol) server that integrates Claude (or any MCP-compatible LLM, if you have the know - how) with Todoist. It enables natural language task management through MCP tools. The tools in this server allow Claude to interact with your Todoist tasks, projects, sections, and labels using everyday language, while being optimized for LLM workflow efficiency.

✨ Features

• Task Management: Create, update, complete, and delete tasks using everyday language.
• Label Management: Create, update, and manage personal and task labels.
• Project Management: Create, update, and manage Todoist projects.
• Section Organization: Create and manage sections within projects.
• Intelligent Search: Find tasks and labels using partial name matching.
• Flexible Filtering: Filter by project, section, due date, priority, and label.
• Rich Task Details: Support descriptions, due dates, priority levels, and project assignments.
• Batch Operations: The tools have built - in support for batch operations and customizable parameters to improve efficiency in LLM workflows.

For a full list of available tools and their usage, please refer to tools.md.

🚀 Quick Start

📦 Installation

Assume you have npm installed.

For a more comprehensive installation guide, please refer to How to Set Up Claude Todoist MCP on Windows.

Install via Smithery

To install the Todoist MCP Server Extended for the Claude desktop client via Smithery:

1. Run the following command in cmd\pwsh:

    npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claude

It is also compatible with cline or windsurf. Just change the last parameter to --client cline or --client windsurf.

Install via npm

1. Run the following command in cmd\pwsh:

    npm install -g @chrusic/todoist-mcp-server-extended

Setup

Get a Todoist Token

To use this server, you need a Todoist API token. Please follow the instructions in the Todoist documentation to obtain your token.