Todoist MCP server

Todoist MCP Server is a powerful integration that connects Claude and other AI assistants with Todoist task management. This server implementation enables natural language interaction with your Todoist account, allowing you to create, manage, and query tasks through conversational commands.

Installation and Setup

Prerequisites

To use the Todoist MCP server, you'll need:

• A Todoist account
• Your Todoist API token

Getting Your Todoist API Token

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

Setting Up with Claude Desktop

To integrate the Todoist MCP server with Claude Desktop:

1. Add the following configuration to your claude_desktop_config.json file:

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

2. Replace your_todoist_api_token_here with your actual Todoist API token

Using Todoist with Claude

Once configured, you can interact with your Todoist account using natural language commands through Claude. Here are some examples of what you can do:

Task Management

You can ask Claude questions like:

• "What tasks do I have due today?"
• "Create a task to review the quarterly report by next Friday"
• "Mark my dentist appointment task as complete"
• "Show me all my high priority tasks"

Project Management

Manage your projects with commands like:

• "Make a new project called 'Home Renovation'"
• "What projects do I have in my Todoist?"
• "Create a new section called 'Planning' in my Work project"

Comments and Labels

You can also work with comments and labels:

• "Add a comment to my meeting prep task"
• "Create a label for 'Urgent' tasks with a red color"
• "Show me all tasks with the 'Important' label"

Available Features

Task Operations

• Get task lists with optional filtering
• Create new tasks with various attributes
• Update existing tasks
• Mark tasks as complete or reopen them
• Delete tasks
• Move tasks between projects or sections

Project Management

• List all projects
• Create new projects
• Update existing projects
• Delete projects
• Manage collaborators
• Move projects to different locations

Section Management

• List all sections or filter by project
• Create new sections
• Update section details
• Delete sections

Comment Management

• Get comments for projects or tasks
• Create new comments
• Update existing comments
• Delete comments

Label Management

• Work with both personal and shared labels
• Create, update, and delete personal labels
• Rename or remove shared labels

Utility Functions

The MCP server also provides utility functions like:

• Getting available colors for projects, labels, and filters
• Generating formatted lists of your projects with their sections

These capabilities make it simple to manage your Todoist workflow through natural conversation with Claude, without having to navigate the Todoist interface directly.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "todoist" '{"command":"npx","args":["-y","todoist-mcp"],"env":{"API_KEY":"your_todoist_api_token_here"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect