Skip to main content
Glama
Todoist MCP Server
by ganievs

Todoist MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Todoist, enabling AI assistants to manage tasks, projects, labels, sections, and comments through the Todoist API.

Configuration

This server requires a Todoist API token to function.

  1. Get your API token:

    • Go to Todoist Settings.

    • Scroll down to the "API token" section.

    • Copy your personal API token.

  2. Configure your MCP client: Add the server to your MCP client configuration, making sure to include your API token. For Claude Desktop, you would add one of the following to your claude_desktop_config.json:

    Docker

    {
      "mcpServers": {
        "todoist": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "TODOIST_API_TOKEN=your_api_token_here",
            "ghcr.io/ganievs/todoist-mcp-server:latest"
          ]
        }
      }
    }

    NPX

    {
      "mcpServers": {
        "todoist": {
          "command": "npx",
          "args": [
            "-y",
            "@ganiev/todoist-mcp-server"
          ],
          "env": {
            "TODOIST_API_TOKEN": "your_api_token_here"
          }
        }
      }
    }

Related MCP server: Todoist MCP

Usage

Once configured, you can use natural language to interact with Todoist through your MCP client:

  • "Create a task to buy groceries with high priority"

  • "List all my projects"

  • "Add a comment to the task about the meeting"

  • "Create a new project for my vacation planning"

  • "Show me all tasks with the 'urgent' label"

Development

To set up the project for development:

  1. Clone the repository:

    git clone https://github.com/ganievs/todoist-mcp-server.git
    cd todoist-mcp-server
  2. Install dependencies:

    npm install
  3. Run the linter:

    npm run lint
  4. Build the project:

    npm run build

Support

For issues and feature requests, please use the GitHub Issues page.

Available Tools

27 tools
add_commentC

Add a comment to a task

Inputs: content (required), task_id, project_id, attachment.

add_labelD

Create a label

Inputs: name (required), color, isFavorite, order.

add_projectB

Create a new Todoist project

Inputs: name (required), parent_id, color, is_favorite, +1 more.

add_sectionB

Create a new section in a Todoist project

Inputs: name (required), project_id (required), order.

add_taskB

Create a TODO task

Inputs: content (required), description, priority, labels, +2 more.

close_taskC

Close a TODO task

Inputs: task_id (required).

delete_commentC

Delete a comment

Inputs: comment_id (required).

delete_labelC

Delete a label

Inputs: label_id (required).

delete_projectC

Delete a Todoist project

Inputs: project_id (required).

delete_sectionC

Delete a Todoist section

Inputs: section_id (required).

delete_taskB

Delete a TODO task

Inputs: task_id (required).

get_commentC

Get a comment

Inputs: comment_id (required).

get_labelB

Get a label

Inputs: label_id (required).

get_projectC

Get details of a Todoist project

Inputs: project_id (required).

get_project_collaboratorsC

Get collaborators for a Todoist project

Inputs: project_id (required), cursor, limit.

get_sectionB

Get details of a Todoist section

Inputs: section_id (required).

get_taskC

Get a TODO task

Inputs: task_id (required).

list_commentsC

List and filter comments

Inputs: task_id, project_id, cursor, limit.

list_labelsC

List and filter labels

Inputs: cursor, limit.

list_projectsC

List all Todoist projects

Inputs: cursor, limit.

list_sectionsB

List all sections in a Todoist project

Inputs: project_id (required), cursor, limit.

list_tasksB

List and filter TODO tasks

Inputs: project_id, label, section_id, parent_id, +1 more.

reopen_taskB

Reopen a TODO task

Inputs: task_id (required).

update_commentC

Update a comment

Inputs: comment_id (required), content (required).

update_projectC

Update an existing Todoist project

Inputs: project_id (required), name, color, is_favorite, +1 more.

update_sectionB

Update an existing Todoist section

Inputs: section_id (required), name (required).

update_taskC

Update a TODO task

Inputs: task_id (required), content (required), description, priority, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 27 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action. There is no overlap in purpose; for example, add_task and add_project operate on different resources, and get_task vs list_tasks are clearly separated.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., add_task, delete_comment, list_projects). The verbs and nouns are standardized, making it easy to predict the naming for any missing operation.

    Tool Count4/5

    27 tools is on the higher end but appropriate given the number of resource types (task, project, section, label, comment) with full CRUD plus extras like close/reopen and collaborators. It could potentially be trimmed but is still well-scoped.

    Completeness4/5

    The set covers all major CRUD lifecycle for tasks, projects, sections, labels, and comments, plus close/reopen for tasks. Minor gaps exist (e.g., no move_task or assign_task) but the core workflows are complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers