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:

• Create and classify labels:

• Organize tasks by section:

• Project management:

• Collaborator overview:

• Comment management:

License

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

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!