MCP Todoist

MCP Todoist is an MCP server that connects AI assistants directly to the Todoist REST API via the Model Context Protocol stdio transport. Designed for developers, knowledge workers, and task managers using MCP-compatible environments like Cursor AI and Claude Desktop, it allows users to manage their daily workflows and projects via conversational AI prompts. Built with Node.js and TypeScript, the server provides direct access to Todoist's core resources, enabling AI models to retrieve existing tasks, create new to-dos with specified priorities and due dates, modify task descriptions, and mark items as complete. It also exposes administrative tools to manage project directories, such as creating, updating, listing, and removing projects. Furthermore, the server features a granular tool visibility control system, allowing users to configure which tools remain public or private depending on their workflow and security requirements. By running locally via tsx, it keeps personal productivity data synced across your task boards and coding workspaces.

Category: Project & Task Management

Tags: productivity, tasks, to-do, todoist

Visit MCP Todoist

How to install and configure MCP Todoist

1. Clone the repository and install dependencies: bash git clone https://github.com/kentaroh7777/mcp-todoist cd mcp-todoist npm install 2. Build the MCP server package: bash cd packages/mcp-server npm run build cd ../.. 3. Obtain your Todoist API token from the Todoist App Console. 4. Add the server to your Cursor configuration file (~/.cursor/mcp.json) or Claude Desktop configuration: json { "mcpServers": { "mcp-todoist": { "command": "tsx", "args": ["/ABSOLUTE/PATH/TO/mcp-todoist/script/run-mcp-server.ts"], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } } 5. Replace the placeholder path and API token with your actual values, then restart your MCP client.

What you can do with MCP Todoist

• Retrieve and review pending Todoist tasks with custom filters and limits directly from your AI chat interface. - Add new tasks with defined labels, descriptions, due dates, and priority levels using conversational natural language prompts. - Mark completed assignments and close resolved tasks automatically when concluding programming or writing sessions. - Organize team initiatives by creating, listing, modifying, and deleting Todoist projects across your workspaces. - Restrict sensitive capabilities like project deletion using the server's configurable tool visibility control system.

Key facts

• https://github.com/kentaroh7777/mcp-todoist
• Project & Task Management
• productivity, tasks, to-do, todoist

Part of MCP Servers

What is MCP Todoist?

MCP Todoist is an open-source Model Context Protocol server built with Node.js and TypeScript. It interfaces with the Todoist REST API over stdio, allowing conversational AI tools to manage tasks and projects directly.

How do I install MCP Todoist?

Clone the repository from GitHub, run npm install, and build the server inside packages/mcp-server. Then, configure your MCP client config file to launch the runner script via tsx with your Todoist API token set in the environment.

Which MCP clients work with MCP Todoist?

MCP Todoist works with any client supporting the standard Model Context Protocol stdio transport. The project includes documented setup instructions for Cursor AI and Claude Desktop.

What tools are included in MCP Todoist?

It provides tools for task management, including fetching, creating, updating, and completing tasks. It also features tools for managing projects and includes a tool visibility system to toggle specific tools between public and private states.

Is MCP Todoist open source?

Yes, MCP Todoist is open-source software licensed under the MIT License, and the source code is hosted on GitHub.