todoist-mcp-server
MCP server for Todoist integration enabling natural language task management with Claude
open-sourcetool-integration
383
Stars
+8
Stars/month
0
Releases (6m)
Star Growth
+1 (0.3%)
Overview
Todoist MCP Server 是一个 Model Context Protocol (MCP) 服务器实现，专门为 Claude AI 助手与 Todoist 任务管理平台的集成而设计。该工具使用户能够通过自然语言与 Claude 对话来管理 Todoist 中的任务，无需学习复杂的命令格式。用户可以使用日常语言创建、更新、完成和删除任务，系统会自动解析意图并执行相应操作。工具支持丰富的任务属性设置，包括任务描述、截止日期、优先级等，并提供智能任务搜索和灵活的过滤功能。通过 MCP 协议的标准化接口，该服务器确保了 Claude 与 Todoist 之间的可靠通信。这种集成特别适合那些已经在使用 Todoist 进行项目管理，同时希望通过 AI 助手提升工作效率的个人和团队。工具的直观错误处理机制提供清晰的反馈，帮助用户更好地理解操作结果。
Deep Analysis
Key Differentiator
vs manual Todoist app: MCP protocol integration lets Claude directly manage tasks through natural conversation, eliminating context-switching between AI and task manager
⚡ Capabilities
- • Natural language Todoist task management via Claude MCP
- • Create tasks with descriptions, due dates, and priority levels
- • Search/filter tasks by date, priority, or project
- • Update task attributes and mark complete
- • Delete tasks through conversational interface
🔗 Integrations
Todoist APIClaude Desktop (MCP)Smithery CLI
✓ Best For
- ✓ Claude Desktop users wanting conversational Todoist management
- ✓ Quick task operations without leaving the AI chat interface
- ✓ Batch task creation and filtering through natural language
✗ Not Ideal For
- ✗ Users without Todoist accounts
- ✗ Complex project management beyond Todoist's scope
- ✗ Non-Claude AI assistants (MCP protocol specific)
Languages
TypeScript/Node.js
Deployment
npm global installSmithery CLI automated installClaude Desktop config
⚠ Known Limitations
- ⚠ Todoist-only — no other task management platform support
- ⚠ Requires valid Todoist API token
- ⚠ Depends on Claude Desktop MCP protocol
- ⚠ Partial name matching for task discovery may miss results
Pros
- + 自然语言交互：支持使用日常语言进行任务管理，无需记忆特定命令格式，大大降低学习成本
- + 功能完整性：覆盖任务管理的完整生命周期，包括创建、查询、更新、完成和删除等所有核心操作
- + 智能搜索与过滤：提供基于部分名称匹配的智能搜索功能，支持按截止日期、优先级等多维度过滤任务
Cons
- - 平台依赖：仅支持 Todoist 平台，无法与其他任务管理工具集成
- - 网络要求：需要稳定的网络连接才能与 Todoist API 通信，离线环境下无法使用
- - API 配置门槛：需要用户手动获取和配置 Todoist API 令牌，对非技术用户可能存在一定难度
Use Cases
- • 日常任务管理：通过与 Claude 对话快速添加、修改日常工作任务，如 '创建明天下午2点的会议任务'
- • 项目进度跟踪：查询和更新项目相关任务状态，如 '显示本周高优先级任务' 或 '将文档审查任务标记为完成'
- • 智能任务规划：利用自然语言描述复杂的任务需求，让 Claude 帮助创建包含详细描述和优先级的结构化任务
Getting Started
1. 安装：运行 `npm install -g @abhiz123/todoist-mcp-server` 或使用 Smithery 自动安装；2. 配置：在 Todoist 设置中获取 API 令牌，然后在 Claude Desktop 配置文件中添加服务器配置和环境变量；3. 首次使用：重启 Claude Desktop 后，直接与 Claude 对话创建第一个任务，如 '帮我创建一个明天截止的重要任务：完成项目报告'