todoist-mcp

A Python MCP server for Todoist that provides safe task rescheduling.

The official Todoist MCP server's task-update tool silently drops reminders and flattens recurring tasks when changing due dates. This server fixes that by routing all date changes through a custom reschedule_task tool that preserves both.

Tools

Read

Write

Rescheduling

update_task deliberately has no due-date parameters in its schema. The model cannot use it to change dates even if instructed to — reschedule_task is the only path.

Setup

Prerequisites

• uv

• A Todoist API token (find it at Todoist → Settings → Integrations → API token)

Install

git clone https://github.com/kpanko/todoist-mcp
cd todoist-mcp
cp .env.example .env
# edit .env and add your token
uv sync

Configure Claude Code

Add to your MCP config (.claude/mcp_config.json or Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "todoist": {
      "command": "uv",
      "args": [
        "--project", "/path/to/todoist-mcp",
        "run", "todoist-mcp"
      ]
    }
  }
}

The server reads TODOIST_API_TOKEN from the environment or from a .env file in the project root. No OAuth or browser auth required — works in headless background services.

Dependencies

• todoist-api-python — official REST client

• fastmcp — MCP server framework

• todoistScheduler — local dependency providing the reschedule logic (reminders via Sync API, recurrence string preservation)

Why not use the official server?

The official server at https://ai.todoist.net/mcp requires OAuth (browser flow), making it unsuitable for background services. It also exposes an update_task tool that accepts due-date parameters, which the Todoist REST API handles by dropping reminders and converting recurring tasks to one-time tasks.