Todoist MCP Server ✅

Connect AI agents to your Todoist tasks via the Model Context Protocol (MCP).

Create, search, complete, and manage your Todoist tasks — all from Claude, Gemini, Cursor, or any MCP-compatible AI agent.

✨ Features

24 tools total — the most comprehensive Todoist MCP server available.

🚀 Quick Start

Install

pip install todoist-mcp

Get Your API Token

1. Go to Todoist Settings → Integrations
2. Scroll to Developer → copy your API Token

📋 Configuration

All credentials are passed via environment variables — no tokens in code.

🔧 Platform Configuration

Claude Desktop

{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp",
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp",
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Cursor

Add to Cursor Settings → MCP:

{
  "todoist": {
    "command": "todoist-mcp",
    "env": {
      "TODOIST_API_TOKEN": "your_api_token_here"
    }
  }
}

💡 Usage Examples

Once configured, ask your AI agent:

• "Show me my tasks for today"
• "Create a task: Buy groceries, due tomorrow, priority 2"
• "Complete the task about groceries"
• "Search for tasks related to meeting"
• "List all my projects"
• "Add a comment to my latest task"

🔐 Runtime Configuration

Change tokens without restarting:

• set_api_token — Switch Todoist account at runtime
• get_current_config — Check current configuration

📄 License

MIT License — see LICENSE for details.