Todoist MCP
A Python-based MCP server for Todoist that enables comprehensive task management, including reading, creating, and updating tasks, projects, and comments. It features a specialized rescheduling tool designed to safely preserve reminders and recurring
What is Todoist MCP?
Todoist MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to python-based mcp server for todoist that enables comprehensive task management, including reading, creating, and updating tasks, projects, and comments. it features a specialized rescheduling tool des...
A Python-based MCP server for Todoist that enables comprehensive task management, including reading, creating, and updating tasks, projects, and comments. It features a specialized rescheduling tool designed to safely preserve reminders and recurring
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- listTasks
- getTask
- createTask
- updateTask
- completeTask
Use Cases
Maintainer
Works with
Installation
NPM
npx -y todoistManual Installation
npx -y todoistConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Todoist MCP
The Todoist MCP server is a Python-based integration built on Doist's official @doist/todoist-ai package that gives AI assistants comprehensive access to Todoist task management, exposing over 40 tools covering tasks, projects, sections, comments, labels, filters, and collaboration features. It includes a specialised rescheduling tool that safely preserves reminders and recurring task settings when moving due dates — a common pain point when managing tasks programmatically. Users can create, update, complete, and search tasks entirely through natural language, making it ideal for anyone who wants their AI assistant to serve as a full Todoist productivity co-pilot.
Prerequisites
- Node.js 18+ (the server is run via npx despite being Python-based in origin — the npm package wraps the runtime)
- A Todoist account (free or Pro)
- Todoist API token from Settings > Integrations > Developer in the Todoist web app
- An MCP-compatible client such as Claude Desktop
Get your Todoist API token
Log in to Todoist, go to Settings > Integrations > Developer, and copy your API token. This is required for the server to authenticate with the Todoist REST API.
Test the server with npx
Run the server directly via npx to verify it starts correctly with your API token before adding it to a permanent config.
TODOIST_API_KEY=your_api_key npx -y todoistAdd the server to Claude Desktop configuration
Open your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json and add the todoist server entry with your API key.
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "todoist"],
"env": {
"TODOIST_API_KEY": "your_api_key_here"
}
}
}
}Restart Claude Desktop
Fully quit and relaunch Claude Desktop so it connects to the Todoist MCP server. The 40+ Todoist tools will be available in your conversation.
Verify connection by listing tasks
Ask Claude to list your current Todoist tasks to confirm the connection is working and the server can authenticate successfully.
Todoist MCP Examples
Client configuration
Full Claude Desktop configuration for the Todoist MCP server using npx.
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "todoist"],
"env": {
"TODOIST_API_KEY": "your_api_key_here"
}
}
}
}Prompts to try
Natural language prompts using the 40+ tools exposed by the Todoist MCP server.
- "List all my overdue tasks in Todoist"
- "Create a task to review the Q4 budget in my Work project, due next Friday"
- "Reschedule all tasks due today that I haven't completed yet to tomorrow"
- "Show me my Todoist productivity stats for this week"
- "Complete the task about sending the project proposal"
- "Add a comment to the 'Website redesign' task saying the mockups are ready"Troubleshooting Todoist MCP
Authentication errors when running the server
Verify your TODOIST_API_KEY is correct by testing it with a curl request: `curl -H 'Authorization: Bearer YOUR_TOKEN' https://api.todoist.com/rest/v2/tasks`. Get a fresh token from Todoist Settings > Integrations > Developer if needed.
Recurring tasks lose their repeat settings after rescheduling
Use the server's dedicated rescheduling tool rather than the general updateTask tool when moving due dates on recurring tasks. The rescheduling tool is specifically designed to preserve reminder and recurrence settings.
npx command not found or takes too long
Ensure Node.js 18+ is installed and `npx` is on your PATH. On first run, npx downloads the package which may take a moment. Consider installing globally with `npm install -g todoist` for faster startup.
Frequently Asked Questions about Todoist MCP
What is Todoist MCP?
Todoist MCP is a Model Context Protocol (MCP) server that python-based mcp server for todoist that enables comprehensive task management, including reading, creating, and updating tasks, projects, and comments. it features a specialized rescheduling tool designed to safely preserve reminders and recurring It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Todoist MCP?
Install via npm with the command: npx -y todoist. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Todoist MCP?
Todoist MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Todoist MCP free to use?
Yes, Todoist MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Todoist MCP Alternatives — Similar Business Applications Servers
Looking for alternatives to Todoist MCP? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Todoist MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Todoist MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.