todoist-mcp by trickster026 - MCP Server

Todoist MCP

A Model Context Protocol (MCP) server for interacting with Todoist's API, providing a structured way to manage your Todoist tasks, projects, sections, and labels programmatically. Just use natural langguage while talking to your AI Agent and it will hit the MCP server and do the tasks for you.

Features

Task Management: Create, read, update, and delete tasks
Project Organization: Manage projects and their hierarchy
Sections: Organize tasks within projects using sections
Labels: Create and manage task labels
Due Dates: Set and manage due dates with natural language processing
Uses Python MCP SDK for MCP Server and integrates Todoist SDK for all the above tasks.

Prerequisites

Python 3.13 or higher
uv for dependency management
Todoist API token (get it from Todoist Integrations)

Installation

Clone the repository:

git clone https://github.com/trickster026/todoist-mcp.git
cd todoist-mcp

Install development dependencies:
```
uv sync
```

Configuration

Windsurf

Go to /home/<user>/.codeium/windsurf/mcp_config.json and add the following:

{
    "mcpServers": {
        "todoist-mcp": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
                "run",
                "server.py"
            ]
            "env": {
                "TODOIST_API_TOKEN": "your_api_token_here"
            }
        }
    }
}

Example

{
    "mcpServers": {
        "todoist-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/home/trickster026/todoist-mcp/src/",
                "run",
                "server.py"
            ],
            "env": {
                "TODOIST_API_TOKEN": "your_api_token_here"
            }
        }
    }
}

trickster026/todoist-mcp