Todoist

🚀 Todoist MCP Server

A Model Context Protocol (MCP) server implementation integrated with Todoist, enabling Claude and other AI assistants to perform task management via natural language.

🚀 Quick Start

To use this MCP server, you need a Todoist API token.

Obtain a Todoist API Token

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

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "todoist-mcp"],
            "env": {
                "API_KEY": "your_todoist_api_token_here"
            }
        }
    }
}

✨ Features

• Full Todoist API Integration: Supports Todoist REST API v2 and Todoist Sync API via natural language.
• Batch Processing: Clients can request to process multiple tasks at once.
• Search by Name: AI can search for tasks, projects, and labels by name without needing an ID.
• Task Management: Create, update, close, reopen, move, and delete tasks using natural language.
• Project Management: Create and manage projects and sections.
• Comment Functionality: Add and manage comments on tasks and projects.
• Label Management: Create and manage personal and shared labels.
• Prompt Support: You can easily provide project information to clients.

📦 Installation

Prerequisites

You need a Todoist API token. Follow the steps in the "Quick Start" section to obtain it.

Installation Steps

# Install the project
npm install

Build and Run

# Build the project and run the inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

💻 Usage Examples

Basic Usage

# Install the project
npm install

# Build the project and run the inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

📚 Documentation

Available Tools

Task Management

• get_tasks_list: Get a list of tasks, optionally filtered by project, section, label, etc.
• create_tasks: Create new tasks with various attributes.
• get_tasks: Get specific tasks by ID or name.
• update_tasks: Update existing tasks.
• close_tasks: Close tasks.
• reopen_tasks: Reopen tasks.
• move_task: Move a task.

Project Management

• create_project: Create a new project.
• get_projects: Get all projects.
• get_project: Get a specific project by ID.
• update_project: Update an existing project.
• delete_project: Delete a project.

Label Management

• create_label: Create a new label.
• get_labels: Get all labels.
• get_label: Get a specific label by ID.
• update_label: Update an existing label.
• delete_label: Delete a label.

📄 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 submit an issue in the GitHub repository.