Todoist
An MCP server that integrates with the Todoist REST API v2 to enable AI assistants to manage tasks, projects, sections, comments, and labels. It supports comprehensive operations including batch task creation, history tracking for completed tasks, an
What is Todoist?
Todoist is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that integrates with the todoist rest api v2 to enable ai assistants to manage tasks, projects, sections, comments, and labels. it supports comprehensive operations including batch task cre...
An MCP server that integrates with the Todoist REST API v2 to enable AI assistants to manage tasks, projects, sections, comments, and labels. It supports comprehensive operations including batch task creation, history tracking for completed tasks, an
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP server that integrates with the Todoist REST API v2 t
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @abhiz123/todoist-mcp-serverManual Installation
npx -y @abhiz123/todoist-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Todoist
The Todoist MCP server integrates the Todoist REST API v2 into AI assistants, enabling natural language task management including creating tasks with due dates and priorities, updating existing items by partial name match, retrieving filtered task lists, marking tasks complete, and deleting tasks. It supports batch operations and tracks completion history, making it a capable productivity bridge between conversational AI and one of the most popular personal task managers. Teams and individual users connect it to Claude Desktop to manage their entire Todoist inbox through chat without opening the Todoist app.
Prerequisites
- Node.js 18+ with npx available
- A Todoist account (free or premium)
- A 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
In the Todoist web app, click your avatar → Settings → Integrations → Developer. Copy the API token shown there — this is your TODOIST_API_TOKEN.
Install via Smithery (quickest method)
Use the Smithery CLI to install and auto-configure the Todoist MCP server for Claude.
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claudeOr configure manually in claude_desktop_config.json
Add the Todoist MCP server block to your Claude Desktop configuration file, supplying your API token as TODOIST_API_TOKEN.
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}
}Restart Claude Desktop
Quit and relaunch Claude Desktop to load the new MCP server. The Todoist tools will appear as available when you start a new conversation.
Verify the connection
Ask Claude to list your current tasks. If the server is connected correctly, it will return tasks from your Todoist inbox.
Todoist Examples
Client configuration
Add the Todoist MCP server to claude_desktop_config.json with your Todoist API token.
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}
}Prompts to try
After connecting the server, use these natural language prompts to manage Todoist tasks through Claude.
- "Create a task 'Prepare Q3 report' with priority 1 and due date next Friday"
- "Show me all high-priority tasks due this week"
- "Update the 'Team meeting' task to be due tomorrow at 10am"
- "Mark the 'PR review' task as complete"
- "Delete the task called 'Old project cleanup'"
- "Create tasks for each step in a basic deployment checklist"Troubleshooting Todoist
Server returns 'Invalid token' or 401 Unauthorized
The TODOIST_API_TOKEN value must match the API token from Settings → Integrations → Developer in Todoist, not your login password. If you recently reset Todoist access, generate a new token from that settings page.
todoist_update_task or todoist_complete_task cannot find the task by name
These tools use partial name matching — provide enough of the task name to be unique. If multiple tasks share similar names, include a distinctive word. Alternatively, use todoist_get_tasks first to see the exact task content.
npx -y @abhiz123/todoist-mcp-server hangs on startup
Check your internet connection, as npx must download the package on first run. If behind a proxy, set HTTP_PROXY and HTTPS_PROXY environment variables. Run the npx command directly in a terminal to see detailed output.
Frequently Asked Questions about Todoist
What is Todoist?
Todoist is a Model Context Protocol (MCP) server that mcp server that integrates with the todoist rest api v2 to enable ai assistants to manage tasks, projects, sections, comments, and labels. it supports comprehensive operations including batch task creation, history tracking for completed tasks, an It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Todoist?
Install via npm with the command: npx -y @abhiz123/todoist-mcp-server. 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?
Todoist works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Todoist free to use?
Yes, Todoist is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Todoist Alternatives — Similar Business Applications Servers
Looking for alternatives to Todoist? 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 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?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.