Todoist MCP Server Extended

An MCP (Model Context Protocol) server implementation that integrates Claude - or any MCP compatible LLM if you're crafty - with Todoist, enabling natural language task management via MCP tools. The tools in this server allows Claude to interact with your Todoist tasks, projects, sections, and labels using everyday language, while also 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: Tools have built in batch operation support and custom parameters for efficient usage with LLM workflows

For a complete list of available tools as well as 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 following command in cmd\pwsh:

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

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

Installing via npm

1. Run following command in cmd\pwsh:

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

Setup

Grab a Todoist API Token

1. Log in to your Todoist account
2. Navigate to Settings → Integrations
3. Find your API token under Developer
4. Press Copy API Token

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

Add MCP Server and API Token Claude Desktop Client

1. In your claude_desktop_config.json file, paste 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 all put together, it should look something like this:

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

3. Claude Desktop client will then start the MCP server and load the tools on the next client (re)start.

Example Usage

Some simple suggestions on what to ask Claude. Note that sometimes you have to be very direct to get claude to use the tools:

• "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 a

... View full README on GitHub