todoist mcp
Todoist的MCP（模型上下文协议）服务器，使AI助手可以完全访问您的任务、项目、标签、过滤器、评论等。
建立在官方 @doist/todoist-ai 包裹。
工具
任务
| 工具 |
说明 |
add-tasks |
创建一个或多个任务 |
find-tasks |
搜索和筛选任务 |
find-tasks-by-date |
按截止日期或日期范围查找任务 |
find-completed-tasks |
查找以前完成的任务 |
update-tasks |
更新现有任务 |
complete-tasks |
将任务标记为已完成 |
uncomplete-tasks |
重新打开已完成的任务 |
reschedule-tasks |
更改任务到期日期 |
项目
| 工具 |
说明 |
add-projects |
创建新项目 |
find-projects |
搜索并列出项目 |
update-projects |
更新项目属性 |
project-management |
存档或非存档项目 |
project-move |
在工作空间之间移动项目 |
章节
| 工具 |
说明 |
add-sections |
在项目中创建部分 |
find-sections |
搜索和列出部分 |
update-sections |
更新节属性 |
评论
| 工具 |
说明 |
add-comments |
向任务或项目添加注释 |
find-comments |
搜索并列出评论 |
update-comments |
更新现有评论 |
view-attachment |
在评论中查看文件附件 |
标签
| 工具 |
说明 |
add-labels |
创建新标签 |
find-labels |
搜索并列出标签 |
过滤器
| 工具 |
说明 |
add-filters |
创建已保存的筛选器 |
find-filters |
搜索和列表筛选器 |
update-filters |
更新现有筛选器 |
协作
| 工具 |
说明 |
find-project-collaborators |
列出项目的合作者 |
manage-assignments |
分配或取消分配任务 |
list-workspaces |
列出可用工作区 |
将军
| 工具 |
说明 |
get-overview |
获取您的Todoist帐户摘要 |
search |
Todoist全文搜索 |
fetch |
获取Todoist URL |
fetch-object |
按ID获取特定任务、项目、部分或评论 |
delete-object |
删除任务、项目、节、标签或其他对象 |
reorder-objects |
重新排序任务、项目或部分 |
find-activity |
查看活动/审核日志 |
get-productivity-stats |
获取您的生产力统计数据 |
user-info |
获取当前用户信息 |
环境变量
| 变量 |
必填 |
描述 |
TODOIST_API_KEY |
是 |
您的Todoist API代币（从 设置>集成>开发人员) |
安装
用法
标准模式（适用于克劳德桌面等）
TODOIST_API_KEY=your_api_key node dist/main.js
或者创建一个 .env 使用API密钥文件：
TODOIST_API_KEY=your_api_key
然后运行：
HTTP模式（独立服务器）
TODOIST_API_KEY=your_api_key node dist/main-http.js
默认情况下，服务器在端口3000上启动（设置 PORT 以覆盖）。MCP端点位于 /mcp 健康检查在 /health.
带有mcp代理的HTTP模式
mcp-proxy --port 8006 -- node dist/main.js
Claude桌面配置
添加到您的Claude Desktop MCP配置中：
{
"mcpServers": {
"todoist": {
"command": "node",
"args": ["/path/to/todoist-mcp/dist/main.js"],
"env": {
"TODOIST_API_KEY": "your_api_key"
}
}
}
}
许可证
麻省理工学院
