home / mcp / mcp todoist mcp server

MCP Todoist MCP Server

Provides Todoist task and project management via MCP by translating calls to Todoist REST API actions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kentaroh7777-mcp-todoist": {
      "command": "tsx",
      "args": [
        "script/run-mcp-server.ts"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_TODOIST_API_TOKEN"
      }
    }
  }
}

You have an MCP server that exposes a Todoist API-compatible interface through a Node.js and TypeScript implementation. This server connects with Todoist to manage tasks and projects via the MCP protocol, enabling AI agents and other clients to call tools like creating, updating, listing, and completing tasks and projects in Todoist through a standardized, protocol-based workflow.

How to use

You interact with the MCP Todoist server through an MCP-enabled client. Start by initializing the server, then call the available tools to retrieve tasks, create or update tasks, manage projects, and mark items as complete. The server exposes a set of tools that you can invoke from your client, and it handles the Todoist API interactions on your behalf so you can focus on higher-level automation and workflows.

How to install

Prerequisites: you need Node.js 18+, npm or yarn, and an environment capable of running MCP servers (like a local shell or an automation tool). You also need a Todoist API token for authenticating requests.

Step 1: Install dependencies

npm install

Step 2: Build the MCP server

cd packages/mcp-server
npm run build
cd ../..

Step 3: Run tests against the MCP server to fetch a task list (example assumes you have a Todoist API token set in the environment). Use the provided test command to exercise the task-list retrieval tool.

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"todoist_get_tasks","arguments":{}}}' | TODOIST_API_TOKEN=your-api-token npx tsx script/run-mcp-server.ts

Additional sections

Configuration and usage details are maintained within the MCP setup. The server supports environment-driven authentication via the Todoist API token, which you provide in the environment variable TODOIST_API_TOKEN. The server implements a set of MCP tools for interacting with Todoist resources.

Available tools

todoist_get_tasks

Retrieve a list of tasks with optional filters such as project, search filters, and limit.

todoist_create_task

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

todoist_update_task

Update an existing Todoist task identified by task_id with new content, description, priority, due date, and labels.

todoist_close_task

Mark a specified task as completed in Todoist.

todoist_get_projects

List all projects accessible in Todoist for the authenticated user.

todoist_create_project

Create a new project with a required name and optional color, parent project, and favorite flag.

todoist_update_project

Update an existing project by project_id with new name, color, or favorite status.

todoist_delete_project

Delete a project specified by project_id.