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

Clone the repository:

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

Install dependencies:
```
npm install
# or
yarn install
```
Build the project:
```
npm run build
# or
yarn build
```
Set your Todoist API token as an environment variable (see above).
Run the built server:
```
node dist/server.js
```

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.

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

Clone the repository:

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

Install dependencies:

npm install
# or
yarn install

Build the project:

npm run build
# or
yarn build

Set your Todoist API token as an environment variable (see above).

Run the built server:

node dist/server.js

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.'"