Todoist MCP Server
Todoist MCP 服务器
一个 MCP(模型上下文协议)服务器实现,将 Claude 与 Todoist 集成,实现自然语言任务管理。此服务器允许 Claude 使用日常语言与您的 Todoist 任务进行交互。
特征
自然语言任务管理:使用日常语言创建、更新、完成和删除任务
智能任务搜索:使用部分名称匹配查找任务
灵活过滤:按截止日期、优先级和其他属性过滤任务
丰富的任务详情:支持描述、截止日期和优先级
直观的错误处理:清晰的反馈以获得更好的用户体验
Related MCP server: Enhanced Todoist MCP Server Extended
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Todoist MCP 服务器:
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude手动安装
npm install -g @abhiz123/todoist-mcp-server工具
todoist_create_task
创建具有各种属性的新任务:
必填:内容(任务标题)
可选:描述、截止日期、优先级(1-4)
示例:“创建任务‘团队会议’,描述为‘每周同步’,明天截止”
todoist_get_tasks
检索和过滤任务:
按截止日期、优先级或项目进行过滤
自然语言日期过滤
可选结果限制
例如:“显示本周截止的高优先级任务”
todoist_update_task
使用自然语言搜索更新现有任务:
通过部分名称匹配查找任务
更新任何任务属性(内容、描述、截止日期、优先级)
例如:“更新下周一截止的会议任务”
todoist_complete_task
使用自然语言搜索将任务标记为完成:
通过部分名称匹配查找任务
确认完成状态
例如:“将文档任务标记为完成”
todoist_delete_task
使用自然语言搜索删除任务:
按名称查找和删除任务
确认消息
示例:“删除 PR 审核任务”
设置
获取 Todoist API 令牌
登录您的 Todoist 帐户
导航至“设置”→“集成”
在“开发者”下找到您的 API 令牌
与 Claude Desktop 一起使用
添加到您的claude_desktop_config.json :
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
}
}
}
}示例用法
创建任务
"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"获取任务
"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"更新任务
"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"完成任务
"Mark the PR review task as complete"
"Complete the documentation task"删除任务
"Delete the PR review task"
"Remove meeting prep task"发展
从源代码构建
# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git
# Navigate to directory
cd todoist-mcp-server
# Install dependencies
npm install
# Build the project
npm run build贡献
欢迎贡献代码!欢迎提交 Pull 请求。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。
问题与支持
如果您遇到任何问题或需要支持,请在GitHub 存储库上提交问题。
Available Tools
5 toolstodoist_complete_taskB
Mark a task as complete by searching for it by name
Inputs: task_name (required).
todoist_create_taskB
Create a new task in Todoist with optional description, due date, and priority
Inputs: content (required), priority, due_string, description.
todoist_delete_taskB
Delete a task from Todoist by searching for it by name
Inputs: task_name (required).
todoist_get_tasksA
Get a list of tasks from Todoist with various filters
Inputs: limit, filter, priority, project_id.
todoist_update_taskB
Update an existing task in Todoist by searching for it by name and then updating it
Inputs: task_name (required), content, priority, due_string, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation (create, read, update, delete, complete) on tasks, with no overlap. The descriptions clearly differentiate the actions.
All tools follow a consistent 'todoist_verb_task' pattern (e.g., todoist_complete_task, todoist_create_task), using snake_case and clear verbs.
With 5 tools, the set covers the essential CRUD operations plus a completion action, which is appropriate for a task management server. No excessive or missing tools.
The tools cover full CRUD (create, get, update, delete) and a common operation (complete), which is sufficient for basic task management. Minor gaps like reordering or sharing tasks are not critical.
Maintenance
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
Simple, fast todo app: manage tasks, projects and tags from Claude and other MCP clients.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that connects Claude with Todoist for complete task and project management through natural language.86203 npm246MIT
- AlicenseBqualityDmaintenanceA comprehensive MCP server that provides full integration between Claude and Todoist, enabling task, project, section, and label management through 24 different tools with the complete Todoist API.306MIT
- AlicenseNot gradedqualityDmaintenanceA custom MCP server that connects Claude to Todoist using a permanent API token, avoiding OAuth re-authentication issues across all Claude surfaces.MIT
- AlicenseAqualityDmaintenanceA local MCP server for Todoist task management, enabling Claude to create, read, update, complete, delete, and move tasks, manage projects and labels, and add comments via the Todoist REST and Sync APIs.151MIT