Todoist MCP Server

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 and Claude Code. ⚠️ 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

npm install
npm run build

Configuration

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

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

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

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:

{
  success: boolean;
  data?: any;        // Present on success
  error?: {          // Present on failure
    code: string;
    message: string;
    details?: any;
  };
}

Development

npm run dev    # Watch mode for development
npm run build  # Build for production
npm run typecheck  # Type check without emitting

License

ISC