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

1. Clone the repository:

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

   Copy

2. Install development dependencies:

   uv sync
   

   Copy

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

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Todoist API
• uv

Future Work

• Refactor Code
• Documentation Enhancements - Add more examples and better documentation.
• Add steps for other AI Agents Setup