Todoist MCP Server

MCP server for Todoist task management. Provides 12 tools for tasks, projects, and labels.

Features

• Tasks: Create, list, update, complete, reopen, and delete tasks

• Projects: List and create projects, including sub-projects

• Labels: List and create labels for task organization

• Filters: Support for Todoist filter syntax (today, overdue, p1, etc.)

• Natural language dates: Use tomorrow, next Monday, every week, etc.

Installation

Option 1: uvx (Recommended)

Zero-install method using uv. Add to ~/.claude.json:

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/IAMSamuelRodda/todoist-mcp", "todoist-mcp"],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token"
      }
    }
  }
}

Option 2: Local Clone

mkdir -p ~/.claude/mcp-servers
git clone https://github.com/IAMSamuelRodda/todoist-mcp.git ~/.claude/mcp-servers/todoist-mcp
cd ~/.claude/mcp-servers/todoist-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Add to ~/.claude.json:

{
  "mcpServers": {
    "todoist": {
      "command": "~/.claude/mcp-servers/todoist-mcp/.venv/bin/python",
      "args": ["~/.claude/mcp-servers/todoist-mcp/todoist_mcp.py"],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token"
      }
    }
  }
}

Get Your API Token

1. Open Todoist (web or app)

2. Go to Settings → Integrations → Developer

3. Copy your API token

Updating

uvx users

uv cache clean todoist-mcp

Local clone users

cd ~/.claude/mcp-servers/todoist-mcp
git pull
source .venv/bin/activate
pip install -r requirements.txt

Available Tools

Usage Examples

Once configured, you can ask Claude:

• "Show me my tasks for today"

• "Create a task to review the quarterly report due next Friday"

• "List all my projects"

• "Mark task 123456789 as complete"

• "What are my overdue tasks?"

• "Create a high-priority task in my Work project"

Filter Syntax

The todoist_list_tasks tool supports Todoist's filter syntax:

• today - Tasks due today

• tomorrow - Tasks due tomorrow

• overdue - Overdue tasks

• p1, p2, p3, p4 - Filter by priority

• no due date - Tasks without due dates

• 7 days - Tasks due in the next 7 days

• @label_name - Tasks with specific label

• #project_name - Tasks in specific project

License

MIT