用途:通过 Rube MCP(Composio)自动化 Todoist,包括任务的创建与管理、项目组织、分区管理、任务筛选和批量任务流程。
前提条件:需连接 Rube MCP(可用 RUBE_SEARCH_TOOLS),并通过 RUBE_MANAGE_CONNECTIONS 使用 todoist 工具包建立活跃的 Todoist 连接;执行任何工作流前必须先调用 RUBE_SEARCH_TOOLS 获取最新的工具 schema。
设置:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器,无需 API 密钥,添加端点即可。确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS(工具包 todoist);若连接非 ACTIVE,按返回的授权链接完成 Todoist OAuth,确认状态为 ACTIVE 后再运行工作流。
主要能力:任务创建、更新、完成、重开、删除和批量创建;项目列出、创建、更新与查看;分区创建、重命名与删除;按筛选语法检索任务、查看已完成任务历史、列出已保存筛选器。
使用方式:创建任务常用参数包括 content、description、project_id、section_id、parent_id、priority(1 正常至 4 紧急)、due_string、due_date、due_datetime、labels、duration 与 duration_unit。同一时间只能使用一个 due_* 字段;不要把截止日期写进 content 或 description。注意 API 优先级与界面相反(界面 p1 为紧急)。筛选使用 filter 语法,如 today、overdue、#项目名、@标签名、search: 关键词,并用 &、|、! 组合,且引用的项目或标签必须真实存在,否则返回 HTTP 400。已完成任务需用 TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE,且时间范围约限 3 个月。批量创建时 tasks 数组中每个任务至少需 content,且其 due 为嵌套对象结构。
适用场景:希望在 MCP 客户端中自动整理 Todoist 任务、按项目或分区批量搭建任务、查询今日或逾期任务、获取指定日期范围的已完成任务。
限制:Todoist API 有速率限制,建议用批量创建并放缓连续请求;部分工具仅接受数字 ID,字母数字 ID 可能报 HTTP 400;响应可能同时含 id 与 v2_id,应使用 API 返回的 id。仅当任务明确匹配上述范围时使用;不得将输出替代针对具体环境的验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。