todoist-mcp-helper 1.1.0

MCP Server for Todoist — Connect AI agents to your Todoist tasks

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

Category	Tools	Description
📋 Tasks	list_tasks, get_task, create_task, update_task, complete_task, delete_task, reopen_task	Full task CRUD with priority, due dates, labels
🔍 Smart Search	search_task_by_name, complete_task_by_name, delete_task_by_name, update_task_by_name	Find and operate on tasks by name (fuzzy matching)
📁 Projects	list_projects, create_project, get_project, delete_project	Manage projects
📑 Sections	list_sections, create_section, delete_section	Organize tasks into sections
🏷️ Labels	list_labels, create_label	Tag management
💬 Comments	list_comments, add_comment	Task comments
⚙️ Config	set_api_token, get_current_config	Runtime token management

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

---

🚀 Quick Start

Install

pip install todoist-mcp-helper

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.

Variable	Description	Required
TODOIST_API_TOKEN	Your Todoist API Token	✅

---

🔧 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.