📌Overview

Purpose: To provide a seamless implementation of an MCP server that integrates natural language task management with Todoist using Claude or any compatible LLM.

Overview: The Todoist MCP Server Extended enables users to manage their Todoist tasks, projects, sections, and labels through natural language input, enhancing efficiency in task management workflows using the Model Context Protocol.

Key Features:

• Task Management: Allows users to create, update, complete, and delete tasks using everyday language, streamlining task handling.

• Label Management: Facilitates the creation and organization of personal and task labels for improved categorization.

• Project Management: Empowers users to create and manage Todoist projects efficiently.

• Section Organization: Provides tools for creating and managing sections within projects, enhancing organizational structure.

• Smart Search: Enables users to find tasks and labels using partial name matches, simplifying retrieval.

• Flexible Filtering: Offers task filtering by project, section, due date, priority, and labels for tailored task visibility.

• Rich Task Details: Supports comprehensive task information including descriptions, due dates, and priority levels.

• Batch Operations: Incorporates built-in support for batch operations and custom parameters, optimizing usage for LLM workflows.

---

Todoist MCP Server Extended

An MCP (Model Context Protocol) server implementation that integrates Claude — or any MCP-compatible LLM — with Todoist, enabling natural language task management via MCP tools. The tools allow Claude to interact with your Todoist tasks, projects, sections, and labels using everyday language, optimized for LLM workflow efficiency.

Features Overview

• Task Management: Create, update, complete, and delete tasks using everyday language
• Label Management: Create, update, and manage personal labels and task labels
• Project Management: Create, update, and manage Todoist projects
• Section Organization: Create and manage sections within projects
• Smart Search: Find tasks and labels using partial name matches
• Flexible Filtering: Filter tasks by project, section, due date, priority, and labels
• Rich Task Details: Support for descriptions, due dates, priority levels, and project/section assignment
• Batch Operations: Built-in batch operation support and custom parameters for efficient usage with LLM workflows

For a complete list of available tools and their usage, see tools.md.

Quick Installation Guide

Assuming you already have npm installed.

A more comprehensive installation guide can be found in the How-to Guide.

Installing via Smithery

To install Todoist MCP Server Extended for Claude Desktop via Smithery:

1. Run the following command in cmd or PowerShell:

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

Also compatible with cline or windsurf by changing the last parameter to --client cline or --client windsurf.

Installing via npm

1. Run the following command in cmd or PowerShell:

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

Setup

Grab a Todoist API Token

1. Log in to your Todoist account at https://www.todoist.com/
2. Navigate to Settings → Integrations
3. Find your API token under Developer
4. Copy your API token

For more information about the Todoist API, visit the official Todoist API documentation.

Add MCP Server and API Token to Claude Desktop Client

1. In your claude_desktop_config.json file, add the following JSON snippet between "mcpServers": { }:

"todoist": {
  "command": "npx",
  "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
  "env": {
      "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE"
  }
}

2. When added, the configuration should look like this:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
      "env": {
        "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE"
      }
    }
  }
}

3. Restart the Claude Desktop client; it will start the MCP server and load the tools on the next client start.

Example Usage

Some example prompts to ask Claude (sometimes being very direct helps):

• "Using the MCP tool: todoist_get_tasks, list all my tasks for the day."
• "Create task 'Review PR' in project 'Work' section 'To Do'"
• "Add label 'Important' to task 'Review PR'"
• "Show all tasks with label 'Important' in project 'Work'"
• "Move task 'Documentation' to section 'In Progress'"
• "Mark the documentation task as complete"
• "Give me some suggestions for listed tasks I can do today as I'm going shopping in town."
• "Break task X down into smaller subtasks and add due dates, x, y, z."

Contributing

Contributions are welcome! Feel free to submit a Pull Request.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Issues and Support

If you encounter any issues or need support, please file an issue on the GitHub repository:
https://github.com/Chrusic/todoist-mcp-server-extended/issues