[!IMPORTANT] Deprecation Notice: This repository is deprecated.

Doist now maintains the official Todoist MCP tools in the new repository: Doist/todoist-ai. Please migrate to the new tools for continued support and updates.

More details here.

Todoist MCP

Connect this Model Context Protocol server to your LLM to interact with Todoist.

Functionality

This integration implements all the APIs available from the Todoist TypeScript Client, providing access to:

Task Management

• Create tasks (with content, descriptions, due dates, priorities, labels, and more)
• Create tasks with natural language (e.g., "Submit report by Friday 5pm #Work")
• Retrieve tasks (individual, filtered, or all tasks)
• Retrieve completed tasks (by completion date or due date)
• Get productivity statistics
• Update tasks
• Move tasks (individually or in batches)
• Close/reopen tasks
• Delete tasks

Project Management

• Create, retrieve, update, and delete projects

Section Management

• Create, retrieve, update, and delete sections within projects

Comment Management

• Add, retrieve, update, and delete comments for tasks or projects

Label Management

• Create, retrieve, update, and delete labels
• Manage shared labels

Collaboration

• Get collaborators for projects

Setup

Build the server app:

npm install
npm run build

Configure Claude:

You must install the Claude desktop app which supports MCP.

You can get your Todoist API key from Todoist > Settings > Integrations > Developer.

Then, in your claude_desktop_config.json, add a new MCP server:

{
    "mcpServers": {
        "todoist-mcp": {
            "command": "node",
            "args": ["/path/to/repo/build/index.js"],
            "env": {
                "TODOIST_API_KEY": "your_todoist_api_key"
            }
        }
    }
}

You can now launch Claude desktop app and ask to update Todoist.

Distribution

Smithery

Install Todoist MCP on Claude Desktop using Smithery:

npx -y @smithery/cli install @miottid/todoist-mcp --client claude

Glama