Chrusic Todoist MCP Server Extended

🚀 Todoist MCP Server Extended

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

🚀 Quick Start

This is an MCP server implementation that integrates Claude with Todoist, enabling task management through natural language. It 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 and task labels.
• Intelligent Search: Find tasks and labels by matching section names.
• Flexible Filtering: Filter tasks by project, section, due date, priority, and label.
• Rich Task Details: Support descriptions, due dates, priority levels, and project assignments.

For a complete list of tools and their usage, refer to tools.md in .docs.

📦 Installation

Installation via Smithery

To automatically install the Todoist Extended Server via Smithery:

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

Manual Installation

Not yet published on npm.

📚 Documentation

Obtain a Todoist API Token

1. Log in to your Todoist account.
2. Go to Settings → Integrations.
3. Find your API token in the "Developers" section.

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

Configure MCP with Cline

Add the following content to your Cline MCP settings file:

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

💻 Usage Examples

Basic Usage

"Create a task 'Review PR' in the 'To-Do' section of the project 'Work'"
"Add the label 'Important' to the task 'Review PR'"
"Show all tasks with the label 'Important' in the project 'Work'"
"Move the task 'Documentation' to the section 'In Progress'"
"Mark the task 'Documentation' as completed"

🔧 Technical Details

Build from Source Code

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

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

# Install dependencies
npm install

# Build the project
npm run build

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License, as detailed in the LICENSE file.

❓ Issues and Support

If you encounter any issues or need support, please submit an issue on the GitHub repository.