Todoist MCP Server

A Model Context Protocol (MCP) server that provides integration with the Todoist REST API v2, enabling AI assistants to manage tasks, projects, sections, comments, and labels.

Note: I used this project to test out Factory.ai -- use with caution.

Features

• Task Management: Create, update, complete, delete, move, and search tasks

• Batch Operations: Create multiple tasks at once

• Project Management: Create, update, and delete projects

• Section Management: Organize tasks within project sections

• Comments: Add rich text comments with markdown support and optional prefixes ([Research], [Prompt], [Context], etc.)

• Labels: Manage personal labels

• Completed Tasks: Access completed task history via Sync API

• Rate Limiting: Built-in handling for Todoist's 450 requests/15 min limit with exponential backoff

Installation

Configuration

1. Get your Todoist API token from Todoist Settings > Integrations > Developer

2. Add to your MCP client configuration (e.g., Claude Desktop):

Important: Never commit your API token to version control. Store it securely in your local MCP configuration.

Available Tools

Task Operations

• todoist_list_tasks - List active tasks with filters

• todoist_get_task - Get a single task

• todoist_create_task - Create a new task

• todoist_update_task - Update an existing task

• todoist_complete_task - Mark task as completed

• todoist_reopen_task - Reopen a completed task

• todoist_delete_task - Delete a task

• todoist_move_task - Move task to different project/section

• todoist_search_tasks - Search tasks by content

• todoist_create_tasks_batch - Create multiple tasks at once

Project Operations

• todoist_list_projects - List all projects

• todoist_get_project - Get a project

• todoist_create_project - Create a new project

• todoist_update_project - Update a project

• todoist_delete_project - Delete a project

Section Operations

• todoist_list_sections - List all sections

• todoist_get_section - Get a section

• todoist_create_section - Create a new section

• todoist_update_section - Update a section

• todoist_delete_section - Delete a section

Comment Operations

• todoist_list_comments - List comments for task/project

• todoist_get_comment - Get a comment

• todoist_create_comment - Create a comment with optional prefix

• todoist_update_comment - Update a comment

• todoist_delete_comment - Delete a comment

• todoist_add_research_comment - Add [Research] prefixed comment

• todoist_add_context_comment - Add [Context] prefixed comment

Label Operations

• todoist_list_labels - List all labels

• todoist_create_label - Create a new label

• todoist_update_label - Update a label

• todoist_delete_label - Delete a label

Completed Tasks

• todoist_list_completed_tasks - List completed tasks

• todoist_get_completed_stats - Get completion statistics

Response Format

All tools return a structured response:

Development

License

ISC