Todoist

Unofficial MCP server to create and list Todoist tasks via MCP-compatible clients.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mehularora8-todoist-mcp": {
      "command": "todoist-mcp-server",
      "args": [],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

You can run a Todoist MCP Server locally to let agents create and list tasks in your Todoist account. This server runs on your machine and communicates with Todoist through your API token, enabling natural language interactions via MCP clients such as Claude Desktop or Cursor.

How to use

After you configure the MCP server with your Todoist API token, you can create tasks and list tasks using natural language through your MCP client. You can create tasks with titles, descriptions, due dates, priorities, labels, and projects, and you can list active tasks filtered by project or Todoist filters.

How to install

Prerequisites: Make sure Python is installed on your machine. You will use pip to install the MCP server package.

pip install todoist-mcp-server

Additional setup and usage notes

Configure your MCP client to run the Todoist MCP server locally and provide your API token so the server can access Todoist on your behalf.

Here are example configurations for popular MCP clients. Copy one of these blocks into your client’s MCP configuration.

{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp-server",
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Troubleshooting and tips

If you encounter errors, verify the package is installed, confirm the API token is correct, ensure the config file is in the expected location, and restart your MCP client after any changes.

Available tools

create_task

Create a new Todoist task with content, optional description, project, due date, priority, and labels

list_active_tasks

List active tasks with optional project filter and Todoist filters; limit results as needed