Todoist

You can run a Todoist MCP Server to manage tasks, projects, sections, labels, comments, and collaborators through MCP-compatible clients. It acts as a bridge between Todoist and MCP clients, letting you create, read, update, and organize Todoist data from tools like Claude Desktop with structured, natural language requests.

How to use

You connect an MCP client to the Todoist MCP Server and use natural language prompts to manage your Todoist workspace. Typical actions include listing tasks, creating tasks, updating projects, moving tasks between sections, labeling items, adding comments, and viewing project collaborators. You can perform these actions through compatible clients by pointing them at the MCP server configuration and supplying your Todoist API token.

Key usage patterns you’ll use most often include asking for top-priority tasks, creating and classifying labels, organizing tasks into sections, managing projects and sections, and reviewing who collaborates on projects. For example you might say: “Show me my top priority tasks,” “Create a new project named Personal Growth with a Reading List section,” or “List all collaborators for the Team Launch project.”

How to install

Prerequisites: you need Node.js v18 or higher and an npm or yarn package manager. You also need a Todoist account and a Todoist API token.

Manual installation steps you can follow to run the server locally:

# 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 (you will pass this to the server)
export TODOIST_API_TOKEN=your_todoist_token

# 5. Run the built server
node dist/server.js

Configuration and usage notes

Configure your MCP client to connect to the Todoist MCP Server and supply your API token as an environment variable. You can start the server locally and point your MCP client at the local build.

Example configuration for Claude Desktop (JSON) to run the MCP server via npx, using your Todoist API token.

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_token"
      }
    }
  }
}

Examples of common actions

Get top priority tasks, create and classify labels, move tasks to a section, manage project sections, and view collaborators on a project. Use natural language prompts in your MCP client to perform these actions and let the server translate them into Todoist operations.

Available tools

Tasks

List, get, create, update, complete, reopen, and delete tasks in Todoist via the MCP server.

Projects

List, get, create, update, archive, unarchive, and delete projects.

Sections

List sections by project, get, create, update, and delete sections.

Labels

List, get, create, update, delete labels and manage shared labels.

Comments

List, get, create, update, and delete comments on tasks or projects.

Collaborators

List project collaborators.