todoist-mcp

Features

Complete Todoist API Integration: Access to the full Todoist REST API v2, and support for the Todoist Sync API through natural language
Batch Processing: Client can process multiple tasks in a single request
Search by name: AI can search for tasks, projects, and labels by name instead of ID
Tasks Management: Create, update, close, reopen, move, and delete tasks using conversational language
Project Management: Create and manage projects and sections
Comments Support: Add and manage comments on tasks and projects
Label Management: Create and manage personal and shared labels

Configuration

You'll need a Todoist API token to use this MCP server.

Getting a Todoist API Token

Log in to your Todoist account
Navigate to Settings → Integrations
Find your API token under "Developer"

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "-y",
        "todoist-mcp"
      ],
      "env": {
        "API_KEY": "your_todoist_api_token_here"
      }
    }
  }
}

Available Tools

Tasks

get_tasks_list: Get tasks with optional filtering by project, section, label, etc.
create_tasks: Create new tasks with various attributes
get_tasks: Get specific tasks by ID or name
update_tasks: Update existing tasks
close_tasks: Mark tasks as complete
reopen_tasks: Reopen completed tasks
delete_tasks: Delete tasks
move_tasks: Move tasks to a different project or section

Projects

get_projects_list: Get all projects
create_projects: Create new projects
get_projects: Get specific projects by ID or name
update_projects: Update existing projects
delete_projects: Delete projects
get_collaborators: Get all collaborators for a project
move_projects: Move projects to a different location or subproject

Sections

get_sections_list: Get all sections or filter by project
create_sections: Create new sections
get_sections: Get specific sections by ID or name
update_sections: Update sections
delete_sections: Delete sections

Comments

get_comments_list: Get comments for a project or task
create_comments: Create new comments
get_comments: Get specific comments by ID
update_comments: Update comments
delete_comments: Delete comments

Labels

get_labels_list: Get all personal labels
create_labels: Create new personal labels
get_labels: Get personal labels by ID or name
update_labels: Update personal labels
delete_labels: Delete personal labels
get_shared_labels: Get all shared labels
rename_shared_labels: Rename shared labels
remove_shared_labels: Remove shared labels

Utils

utils_get_colors: Get available colors for projects, labels, filters

Example Usage

Ask your AI assistant (like Claude) questions such as:

"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"

Development

# Install dependencies
npm install

# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

License

This project is licensed under the MIT License - see the LICENSE file for details.

Issues and Support

If you encounter any issues or need support, please file an issue on the GitHub repository.

Integrations