Todoist Mcp

Todoist MCP Server

[](https://smithery.ai/server/@stevengonsalvez/todoist-mcp)

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:

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

1. Install dependencies:

``sh npm install # or yarn install ``

1. Build the project:

``sh npm run build # or yarn build ``

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

``sh node dist/server.js ``

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

``json { "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](LICENSE) for details.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: stevengonsalvez
• Source: stevengonsalvez/todoist-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.