What is Todoist Mcp

todoist-mcp is a Model Context Protocol (MCP) server designed for Todoist, facilitating advanced task and project management through Claude Desktop and other MCP-compatible clients.

Use cases

Use cases for todoist-mcp include managing personal tasks, coordinating team projects, organizing software development tasks, and tracking project progress with comments and collaborators.

How to use

To use todoist-mcp, you need to install it via npm or yarn, set up your Todoist API token as an environment variable, and configure it in your Claude Desktop. You can also manually clone the repository and build the project.

Key features

Key features include task management (list, create, update, complete, delete), project management (list, create, update, archive, delete), section and label management, comment handling, and collaboration features.

Where to use

todoist-mcp can be used in various fields requiring task and project management, such as personal productivity, team collaboration, project management, and software development.

Todoist MCP Server

A Model Context Protocol (MCP) server for Todoist, enabling advanced task and project management via Claude Desktop and other MCP-compatible clients.

Requirements

• Node.js (v18 or higher recommended)
• npm or yarn
• A Todoist account
• A Todoist API token (see https://todoist.com/prefs/integrations)

Features

• List, create, update, complete, reopen, and delete tasks
• List, create, update, archive, unarchive, and delete projects
• List, create, update, and delete sections
• List, create, update, and delete labels
• List, create, update, and delete comments
• Manage shared labels
• Fetch project collaborators

All Features

• Tasks: List, get, create, update, complete, reopen, delete
• Projects: List, get, create, update, archive, unarchive, delete
• Sections: List (by project), get, create, update, delete
• Labels: List, get, create, update, delete, manage shared labels
• Comments: List (by task/project), get, create, update, delete
• Collaborators: List project collaborators

Installation

For Claude Desktop (JSON)

If published as an npm package, you can use it directly with npx in your Claude Desktop configuration:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_token"
      }
    }
  }
}

• Set the TODOIST_API_TOKEN as shown.

Manual Installation

1. Clone the repository:

   git clone https://github.com/yourusername/todoist-mcp.git
   cd todoist-mcp
   

2. Install dependencies:

   npm install
   # or
   yarn install
   

3. Build the project:

   npm run build
   # or
   yarn build
   

4. Set your Todoist API token as an environment variable (see above).
5. Run the built server:

   node dist/server.js
   

6. Configure Claude Desktop to use your local build by adding this to your config file:

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

Usage Examples

• Get top priority tasks:

  “Show me my top priority tasks.”

• Create and classify labels:

  “Create labels for my tasks and classify them by project or urgency.”

• Organize tasks by section:

  “Move all tasks with the label ‘urgent’ to the ‘Today’ section.”

• Project management:

  “Create a new project called ‘Personal Growth’ and add a section ‘Reading List’.”

• Collaborator overview:

  “List all collaborators for the project ‘Team Launch’.”

• Comment management:

  “Add a comment to the task ‘Prepare slides’ with the content ‘Remember to include Q2 results.’”

License

This project is licensed under the MIT License. See LICENSE for details.