Todoist MCP Server

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.