Todoist MCP Server

MIT License

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

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:

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

-
security - not tested
-
license - not tested
-
quality - not tested

A Model Context Protocol server that enables advanced task and project management in Todoist via Claude Desktop and other MCP-compatible clients.

  1. Requirements
    1. Features
      1. All Features
        1. Installation
          1. For Claude Desktop (JSON)
          2. Manual Installation
        2. Usage Examples
          1. License

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude.
              Last updated -
              117
              Python
              MIT License
            • A
              security
              A
              license
              A
              quality
              Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
              Last updated -
              10
              322
              28
              JavaScript
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
              Last updated -
              3
              Python
              MIT License
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.
              Last updated -
              10
              4
              TypeScript
              MIT License

            View all related MCP servers

            ID: fsr4mtby9i