Todoist Extended

Enhanced Todoist MCP Server Extended

Extended Version - Forked and enhanced by kydycode from the original @abhiz123/todoist-mcp-server

A comprehensive MCP (Model Context Protocol) server implementation that provides full integration between Claude and Todoist. This extended version includes additional features, improved compatibility, and enhanced functionality using the complete Todoist API with the latest MCP SDK (@doist/[email protected]). Completed tasks retrieval uses the Todoist REST API v1.

🆕 Extended Version Features

🔧 Technical Improvements

• Updated Todoist SDK: Now using @doist/[email protected].
• Updated MCP SDK Compatibility: Compatible with MCP SDK 0.5.0.
• Enhanced Error Handling: Comprehensive error handling with detailed error messages.
• Improved TypeScript Support: Better type safety and compatibility.
• Optimized API Usage: Efficient use of Todoist API, including getTasksByFilter for robust search and moveTasks for semantic task movement.
• Better Response Formatting: Enhanced task, project, and label formatting for better readability, including project names in search results.

✨ Enhanced Task Management (11 Tools)

• Direct ID-based Operations: Efficient task operations using task IDs.
• Comprehensive Task Creation: Support for subtasks, labels, projects, sections, priorities.
• Quick Add Integration: Natural language task creation using Todoist's Quick Add.
• Advanced Task Search: Robust keyword search using Todoist's filter engine (search: your query).
• Task Movement Capabilities: Move tasks between projects, sections, or make them subtasks.
• Bulk Task Operations: Move multiple tasks with subtasks in a single operation.
• Task State Management: Complete, reopen, and manage task lifecycle.
• Detailed Task Output: Search and get-task operations return more task details.

🗂️ Complete Project Management (5 Tools)

• Full Project CRUD: Create, read, update, delete projects with all properties.
• Sub-project Support: Create hierarchical project structures.
• Project Customization: Set colors, favorites, view styles (list/board).
• Enhanced Project Listing: Improved project retrieval with pagination and detailed formatting.

📋 Section Management (4 Tools)

• Complete Section Operations: Create, read, update, delete sections.
• Project-specific Sections: Filter and manage sections within projects.
• Section Organization: Proper ordering and structure management.

🏷️ Label Management (5 Tools)

• Full Label CRUD: Create, read, update, delete labels.
• Label Customization: Set names, colors, favorites, order.
• Paginated Label Listing: Efficiently retrieve all labels.

💬 Comment Management (5 Tools)

• Complete Comment CRUD: Create, read, update, delete comments on tasks and projects.
• Attachment Support: Add file attachments to comments with metadata.
• Flexible Targeting: Comments can be attached to either tasks or projects.
• Paginated Comment Retrieval: Efficiently browse through comment threads.

✅ Completed Tasks History (1 Tool) 🆕

• REST API v1 Integration: Access completed task history via Todoist API v1 (/api/v1/tasks/completed/by_completion_date). Migrated from deprecated Sync API v9.
• Flexible Filtering: Filter by project, section, date range (since/until).
• Cursor-based Pagination: Efficient retrieval of large histories.
• Rich Metadata: Shows labels, priorities, descriptions, note counts, completion timestamps.

🛠️ Available Tools (Total 31)

Task Operations (11 tools)

Tool	Description
todoist_create_task	Create tasks with full options (subtasks, labels, projects, sections, priorities).
todoist_quick_add_task	Natural language task creation using Todoist's Quick Add syntax.
todoist_get_tasks	Retrieve tasks with filtering (project, section, parent, label, IDs) and pagination.
todoist_get_task	Get a specific task by its ID, with detailed information.
todoist_update_task	Update task properties (content, description, due date, priority, labels).
todoist_delete_task	Delete task by ID.
todoist_complete_task	Mark task complete.
todoist_reopen_task	Reopen completed task.
todoist_search_tasks	Search tasks using Todoist's filter engine (e.g., search: keyword).
todoist_move_task	Move a task to a different project, section, or make it a subtask.
todoist_bulk_move_tasks	Move multiple tasks with their subtasks to a project, section, or parent task.

Project Operations (5 tools)

Tool	Description
todoist_get_projects	List all active projects with pagination support.
todoist_get_project	Get a specific project by its ID.
todoist_create_project	Create new project (name, color, favorite, view style, sub-projects).
todoist_update_project	Update project properties.
todoist_delete_project	Delete project by ID.

Section Operations (4 tools)

Tool	Description
todoist_get_sections	List sections (all sections or project-specific).
todoist_create_section	Create section in project (name, project, ordering).
todoist_update_section	Update section name.
todoist_delete_section	Delete section by ID.

Label Operations (5 tools)

Tool	Description
todoist_create_label	Create a new label (name, color, favorite, order).
todoist_get_label	Get a specific label by its ID.
todoist_get_labels	List all labels with pagination support.
todoist_update_label	Update an existing label by its ID (name, color, favorite, order).
todoist_delete_label	Delete a label by its ID.

Comment Operations (5 tools)

Tool	Description
todoist_create_comment	Create a new comment on a task or project (with attachments).
todoist_get_comment	Get a specific comment by its ID.
todoist_get_comments	Get comments for a task or project with pagination support.
todoist_update_comment	Update an existing comment by its ID.
todoist_delete_comment	Delete a comment by its ID.

Completed Tasks Operations (1 tool) 🆕

Tool	Description
todoist_get_completed_tasks	Get completed tasks history with filtering by project, section, date range (since/until required), and cursor-based pagination. Uses Todoist REST API v1.

🚀 Installation & Setup

Local Development Setup

# Clone the extended repository
git clone https://github.com/kydycode/todoist-mcp-server-ext.git
cd todoist-mcp-server-ext

# Install dependencies
npm install

# Build the project
npm run build

Getting a Todoist API Token

1. Log in to your Todoist account
2. Navigate to Settings → Integrations → Developer
3. Copy your API token

Usage with Claude Desktop

Add to your claude_desktop_config.json:

Option 1: Run locally built version

{
  "mcpServers": {
    "todoist-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/todoist-mcp-server-ext/dist/index.js"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Option 2: Run via npm/npx (recommended for published version)

{
  "mcpServers": {
    "todoist-mcp-server": {
      "command": "npx",
      "args": ["-y", "@kydycode/todoist-mcp-server-ext@latest"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Option 3: Install globally first

# Install the extended version globally
npm install -g @kydycode/todoist-mcp-server-ext@latest

# Then use in Claude Desktop config
{
  "mcpServers": {
    

---

*README truncated. [View full README on GitHub](https://github.com/kydycode/todoist-mcp-server-ext).*