Todoist MCP Server Enhanced

An MCP (Model Context Protocol) server implementation that integrates Claude with Todoist, enabling natural language task management. This server allows Claude to interact with your Todoist tasks, projects, sections, and labels using everyday language.

Features

• Project Management: Create, update, and manage Todoist projects
• Section Organization: Create and manage sections within projects
• Task Management: Create, update, complete, and delete tasks using everyday language
• Label Management: Create, update, and manage personal labels and task labels
• 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

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

Installation

Installing via Smithery

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

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

Manual Installation

not-published-on-npm-yet

Setup

Getting a Todoist API Token

1. Log in to your Todoist account
2. Navigate to Settings → Integrations
3. Find your API token under "Developer"

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

Usage with Cline

Add to your Cline MCP settings file:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["todoist-mcp-enhanced-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Example Usage

Basic Operations

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

Development

Building from source

# Clone the repository
git clone https://github.com/Chrusic/todoist-mcp-server-extended.git

# Navigate to directory
cd todoist-mcp-server-extended

# Install dependencies
npm install

# Build the project
npm run build

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.