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:

• 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.