Todoist

This MCP server lets Claude interact with Todoist using natural language. You can create, update, search, complete, and delete tasks simply by describing what you want, making task management faster and more intuitive without leaving your chat flow.

How to use

You connect an MCP client to the Todoist MCP Server and then talk to Claude to manage tasks in plain language. Use natural language prompts to create tasks, search for tasks with smart filtering, update task attributes, mark tasks as complete, or delete tasks. Typical workflows include creating a task with a due date and optional description, listing tasks by priority or due date, updating a task’s details, and removing tasks you no longer need.

How to install

Prerequisites you need before installation are Node.js and npm installed on your system. Ensure you have a Todoist API token ready to authorize the MCP server.

# Install the Todoist MCP Server globally
npm install -g @abhiz123/todoist-mcp-server

Additional setup and usage details

Configure the MCP client to point to the Todoist MCP Server using the following runtime configuration. Provide your Todoist API token to authorize access.

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

Usage examples

Examples of common prompts you can use with Claude to manage tasks include creating tasks with descriptions and due dates, listing tasks filtered by priority or due date, updating task details, completing tasks, and deleting tasks.

Available tools

todoist_create_task

Create new tasks with attributes such as content, optional description, due date, and priority. Examples include creating a task with a due date and an optional description.

todoist_get_tasks

Retrieve tasks with optional filters by due date, priority, or project. Supports natural language date filtering and limiting results.

todoist_update_task

Update existing tasks using a partial name match to locate targets and modify attributes like content, description, due date, or priority.

todoist_complete_task

Mark matched tasks as complete based on a partial name match and confirmation of completion status.

todoist_delete_task

Delete tasks found by a partial name match and provide confirmation messaging.