todoist-automation - SKILL

name: todoist-automationdescription: “Automate Todoist task management, projects, sections, filtering, and bulk operations via Rube MCP (Composio). Always search tools first for current schemas.”risk: criticalsource: communitydate_added: “2026-02-27”通过 Rube MCP 实现 Todoist 自动化通过 Composio 的 Todoist 工具包自动化 Todoist 操作包括任务创建与管理、项目组织、分区管理、过滤以及批量任务工作流。前提条件Rube MCP 必须已连接RUBE_SEARCH_TOOLS可用通过RUBE_MANAGE_CONNECTIONS以todoist工具包建立有效的 Todoist 连接始终先调用RUBE_SEARCH_TOOLS以获取当前工具架构设置获取 Rube MCP在客户端配置中将https://rube.app/mcp添加为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。通过确认RUBE_SEARCH_TOOLS有响应来验证 Rube MCP 可用使用todoist工具包调用RUBE_MANAGE_CONNECTIONS如果连接未处于 ACTIVE 状态请按照返回的认证链接完成 Todoist OAuth在运行任何工作流之前确认连接状态显示为 ACTIVE核心工作流1. 创建与管理任务何时使用用户想要创建、更新、完成、重新打开或删除任务工具顺序TODOIST_GET_ALL_PROJECTS- 列出项目以查找目标项目 ID [前提条件]TODOIST_GET_ALL_SECTIONS- 列出项目内的分区以确定任务放置位置 [可选]TODOIST_CREATE_TASK- 使用内容、截止日期、优先级、标签创建单个任务 [必需]TODOIST_BULK_CREATE_TASKS- 在单个请求中创建多个任务 [替代方案]TODOIST_UPDATE_TASK- 修改任务属性内容、截止日期、优先级、标签[可选]TODOIST_CLOSE_TASK- 将任务标记为已完成 [可选]TODOIST_REOPEN_TASK- 恢复先前已完成的任务 [可选]TODOIST_DELETE_TASK- 永久删除任务 [可选]CREATE_TASK 的关键参数content任务标题支持 Markdown 和超链接description附加说明不要在此放置截止日期project_id字母数字项目 ID省略则添加到收件箱section_id字母数字分区 ID用于确定项目内的放置位置parent_id用于创建子任务的任务 IDpriority1普通到 4紧急——注意Todoist 界面显示 p1紧急API 中 p4紧急due_string自然语言日期如tomorrow at 3pm、every Friday at 9amdue_date特定日期YYYY-MM-DD格式due_datetimeRFC3339 格式YYYY-MM-DDTHH:mm:ssZ的特定日期时间labels标签名称字符串数组durationduration_unit任务持续时间例如30minute陷阱一次只能使用一个due_*字段due_lang例外它可以伴随任意一个使用不要在content或description中嵌入截止日期——请使用due_string字段不要在due_string中嵌入持续 30 分钟之类的持续时间短语——请使用durationduration_unitAPI 中的priority1普通4紧急与 Todoist 界面显示相反界面中 p1紧急任务 ID 可以是数字或字母数字请使用 API 返回的格式CLOSE_TASK标记为已完成DELETE_TASK永久删除——它们是不同的操作2. 管理项目何时使用用户想要列出、创建、更新或查看项目工具顺序TODOIST_GET_ALL_PROJECTS- 列出所有项目及元数据 [必需]TODOIST_GET_PROJECT- 按 ID 获取特定项目的详细信息 [可选]TODOIST_CREATE_PROJECT- 使用名称、颜色、视图样式创建新项目 [可选]TODOIST_UPDATE_PROJECT- 修改项目属性 [可选]关键参数name项目名称创建时必需colorTodoist 调色板颜色例如blue、red、green、charcoalview_stylelist列表或board看板布局parent_id用于创建子项目的父项目 IDis_favorite/favorite布尔值标记为收藏project_id更新和获取操作必需陷阱名称相似的项目可能导致选择错误的 project_id务必核实CREATE_PROJECT使用favorite而UPDATE_PROJECT使用is_favorite——字段名不同下游操作请使用 API 返回的项目id而不是v2_id字母数字/URL 样式的项目 ID 可能导致某些工具出现 HTTP 400有数字 ID 时请使用数字 ID3. 管理分区何时使用用户想要使用分区来组织项目内的任务工具顺序TODOIST_GET_ALL_PROJECTS- 查找目标项目 ID [前提条件]TODOIST_GET_ALL_SECTIONS- 列出现有分区以避免重复 [前提条件]TODOIST_CREATE_SECTION- 在项目中创建新分区 [必需]TODOIST_UPDATE_SECTION- 重命名现有分区 [可选]TODOIST_DELETE_SECTION- 永久删除分区 [可选]关键参数project_id必需——要在其中创建分区的项目name分区名称创建时必需order项目内的整数位置数值越小越靠前section_id更新和删除操作必需陷阱CREATE_SECTION需要project_id和name——省略 project_id 会导致 400 错误使用字母数字 ID 时可能出现 HTTP 400 “project_id is invalid”项目 ID 无效优先使用数字 ID删除分区可能会以不明显的方式移动或重新分组其任务响应可能同时包含id和v2_id请一致地存储并复用正确的标识符始终先检查现有分区避免创建重复项4. 搜索和过滤任务何时使用用户想要按条件查找任务、查看今日任务或获取已完成任务历史工具顺序TODOIST_GET_ALL_TASKS- 获取未完成任务可带可选过滤查询 [必需]TODOIST_GET_TASK- 按 ID 获取特定任务的完整详情 [可选]TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE- 检索日期范围内的已完成任务 [可选]TODOIST_LIST_FILTERS- 列出用户的已保存自定义过滤条件 [可选]GET_ALL_TASKS 的关键参数filterTodoist 过滤语法字符串关键字today今天、tomorrow明天、overdue已逾期、no date无日期、recurring重复、subtask子任务优先级p1紧急、p2、p3、p4普通项目#项目名称必须存在于账户中标签标签名称必须存在于账户中日期范围7 days7 天、-7 days前 7 天、due before: YYYY-MM-DD截止于……之前、due after: YYYY-MM-DD截止于……之后搜索search: 关键字用于内容文本搜索运算符与、|或、!非ids要检索的特定任务 ID 列表GET_COMPLETED_TASKS_BY_COMPLETION_DATE 的关键参数sinceRFC3339 格式的开始日期例如2024-01-01T00:00:00ZuntilRFC3339 格式的结束日期project_id、section_id、parent_id可选过滤条件cursor来自前一次响应的分页游标limit每页最大结果数默认 50陷阱GET_ALL_TASKS仅返回未完成的任务已完成任务请使用GET_COMPLETED_TASKS_BY_COMPLETION_DATE过滤条件必须引用实际存在的实体任意文本会导致 HTTP 400 错误不要在 GET_ALL_TASKS 过滤器中使用completed、!completed或completed after——会导致 400 错误GET_COMPLETED_TASKS_BY_COMPLETION_DATE将since和until之间的日期范围限制为大约 3 个月搜索使用过滤器内的search: 关键字语法而不是单独的参数5. 批量创建任务何时使用用户想要一次性搭建包含多个任务的项目工具顺序TODOIST_GET_ALL_PROJECTS- 查找目标项目 ID [前提条件]TODOIST_GET_ALL_SECTIONS- 查找用于任务放置的分区 ID [可选]TODOIST_BULK_CREATE_TASKS- 在单个请求中创建多个任务 [必需]关键参数tasks任务对象数组每个对象至少需要content每个任务对象支持content、description、project_id、section_id、parent_id、priority、labels、due包含string、date或datetime的对象、duration、order陷阱数组中的每个任务必须至少包含content字段批量创建中的due字段是一个包含嵌套字段string、date、datetime、lang的对象——与 CREATE_TASK 的扁平字段结构不同所有任务可以在同一批次中指向不同的项目/分区常见模式ID 解析在操作之前始终将人类可读的名称解析为 ID项目名称 - 项目 IDTODOIST_GET_ALL_PROJECTS按name字段匹配分区名称 - 分区 ID使用project_id调用TODOIST_GET_ALL_SECTIONS任务内容 - 任务 ID使用filter或search: 关键字调用TODOIST_GET_ALL_TASKS分页TODOIST_GET_ALL_TASKS返回所有匹配的未完成任务无需分页TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE使用基于游标的分页跟随响应中的cursor直到没有更多结果TODOIST_GET_ALL_PROJECTS和TODOIST_GET_ALL_SECTIONS返回所有结果无需分页截止日期处理自然语言使用due_string例如tomorrow at 3pm、every Monday特定日期使用YYYY-MM-DD格式的due_date特定日期时间使用 RFC3339 格式YYYY-MM-DDTHH:mm:ssZ的due_datetime一次只使用一个截止日期字段due_lang例外它可以伴随任意一个使用重复任务在due_string中使用自然语言例如every Friday at 9am已知陷阱ID 格式任务 ID 可以是数字2995104339或字母数字6X4Vw2Hfmg73Q2XR项目 ID 也各不相同优先使用 API 返回的格式某些工具只接受数字 ID如果出现 400 错误请尝试通过 GET_PROJECT 获取数字id响应对象可能同时包含id和v2_idAPI 操作请使用id优先级反转API 优先级1 普通4 紧急Todoist 界面显示p1 紧急p4 普通这是相反的始终与用户确认他们指的是哪种约定过滤语法过滤条件必须引用用户账户中的真实实体#不存在的项目或不存在的标签会导致 HTTP 400文本搜索请使用search: 关键字不要使用裸关键字使用与、|或、!非组合completed过滤器在 GET_ALL_TASKS 端点上不生效速率限制Todoist API 有速率限制批量操作应尽可能使用BULK_CREATE_TASKS间隔开快速的连续请求避免被限流快速参考任务工具标识关键参数列出所有项目TODOIST_GET_ALL_PROJECTS无获取项目TODOIST_GET_PROJECTproject_id创建项目TODOIST_CREATE_PROJECTname,color,view_style更新项目TODOIST_UPDATE_PROJECTproject_id,name,color列出分区TODOIST_GET_ALL_SECTIONSproject_id创建分区TODOIST_CREATE_SECTIONproject_id,name,order更新分区TODOIST_UPDATE_SECTIONsection_id,name删除分区TODOIST_DELETE_SECTIONsection_id获取所有任务TODOIST_GET_ALL_TASKSfilter,ids获取任务TODOIST_GET_TASKtask_id创建任务TODOIST_CREATE_TASKcontent,project_id,due_string,priority批量创建任务TODOIST_BULK_CREATE_TASKStasks数组更新任务TODOIST_UPDATE_TASKtask_id,content,due_string完成任务TODOIST_CLOSE_TASKtask_id重新打开任务TODOIST_REOPEN_TASKtask_id删除任务TODOIST_DELETE_TASKtask_id已完成任务TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATEsince,until列出过滤条件TODOIST_LIST_FILTERSsync_token何时使用本技能适用于执行概述中描述的工作流或操作。局限性仅当任务与上述范围明确匹配时使用本技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少必需的输入、权限、安全边界或成功标准请停下来请求澄清。