Todoist

by chrusic

14 stars

447 downloads

Not rated

GitHub

About

Integrates with Todoist API to enable advanced task and project management capabilities including natural language processing for task creation and updates.

Details

Author: chrusic
Repository: Chrusic/todoist-mcp-server-extended
GitHub stars: 14
Downloads: 447
License: MIT License
Categories: Productivity, Design, Developer Tools, AI, API, Infrastructure, Frontend

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.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Todoist

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @chrusic/todoist-mcp-server-extended
Environment
- TODOIST_API_TOKEN PASTE-YOUR-API-TOKEN-HERE
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Assuming you already have npm installed.

A more comprehensive installation guide can be found in the How-to Guide.

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

1. Run following command in cmd\pwsh:

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

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 as complete"
"Give me some suggestions for listed tasks I can do today as I'm going shopping in town."
"Break task X down in to smaller subtasks and add due dates, x, y, z."

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

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

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:

``bash 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":{ }:

 json

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

    {

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

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.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

Todoist MCP Server Extended

Features Overview

Quick Installation Guide

Installing via Smithery

Installing via npm

Setup

Grab a Todoist API Token

Add MCP Server and API Token Claude Desktop Client

Example Usage

Contributing

License

Issues and Support

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7