SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场todoist-automation

todoist-automation

办公与效率

查看项目

更新于 10-15 12:41

技能介绍

用途

Todoist Automation 用于通过 Rube MCP（Composio）自动化 Todoist 的任务管理、项目组织、分区管理、筛选查询与批量操作。

前置条件

  • 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
  • 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Todoist 连接，toolkit 为 todoist。
  • 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

设置

  1. 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS，toolkit 为 todoist。
  4. 若连接不是 ACTIVE，按返回的授权链接完成 Todoist OAuth。
  5. 确认连接状态为 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（省略则加入 Inbox）、section_id、parent_id（创建子任务）、priority（1 普通至 4 紧急；注意 Todoist UI 显示 p1=紧急，API p4=紧急）、due_string（自然语言日期，如 "tomorrow at 3pm"、"every Friday at 9am"）、due_date（YYYY-MM-DD）、due_datetime（RFC3339）、labels（字符串数组）、duration + duration_unit。 注意：一次只能使用一个 due_* 字段（due_lang 除外）；不要把截止日期嵌入 content 或 description；不要把时长短语嵌入 due_string；CLOSE_TASK 是标记完成，DELETE_TASK 是永久删除。

2. 管理项目

适用：列出、创建、更新或查看项目。 工具序列：TODOIST_GET_ALL_PROJECTS（必需）、TODOIST_GET_PROJECT（可选）、TODOIST_CREATE_PROJECT（可选）、TODOIST_UPDATE_PROJECT（可选）。 关键参数：name、color、view_style（"list" 或 "board"）、parent_id、is_favorite / favorite、project_id。 注意：CREATE_PROJECT 使用 favorite，UPDATE_PROJECT 使用 is_favorite；下游操作使用 API 返回的 id，而非 v2_id；部分工具可能因字母数字 ID 返回 HTTP 400，优先使用数字 ID。

3. 管理分区

适用：用分区组织项目内任务。 工具序列：TODOIST_GET_ALL_PROJECTS（前置）、TODOIST_GET_ALL_SECTIONS（前置，避免重复）、TODOIST_CREATE_SECTION（必需）、TODOIST_UPDATE_SECTION（可选）、TODOIST_DELETE_SECTION（可选）。 关键参数：project_id、name、order、section_id。 注意：CREATE_SECTION 需要 project_id 和 name；字母数字 ID 可能触发 HTTP 400；删除分区可能以非显而易见的方式移动或重组任务；响应可能同时包含 id 和 v2_id，需一致使用正确标识符。

4. 搜索与筛选任务

适用：按条件查找任务、查看今日任务或获取已完成任务历史。 工具序列：TODOIST_GET_ALL_TASKS（必需）、TODOIST_GET_TASK（可选）、TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE（可选）、TODOIST_LIST_FILTERS（可选）。 GET_ALL_TASKS 关键参数：filter（Todoist 筛选语法，支持 today、tomorrow、overdue、no date、recurring、subtask、p1-p4、#ProjectName、@LabelName、日期范围、search: 关键词、& | ! 运算符）、ids。 GET_COMPLETED_TASKS_BY_COMPLETION_DATE 关键参数：since、until（RFC3339）、project_id、section_id、parent_id、cursor、limit（默认 50）。 注意：GET_ALL_TASKS 只返回未完成任务；筛选词必须引用真实存在的实体；不要在 GET_ALL_TASKS 中使用 completed 相关筛选；已完成任务日期范围约限制在 3 个月内；搜索使用 search: 关键词语法。

5. 批量创建任务

适用：一次性为项目搭建多个任务。 工具序列：TODOIST_GET_ALL_PROJECTS（前置）、TODOIST_GET_ALL_SECTIONS（可选）、TODOIST_BULK_CREATE_TASKS（必需）。 关键参数：tasks 数组，每个任务至少需要 content，支持 content、description、project_id、section_id、parent_id、priority、labels、due（对象，含 string、date、datetime、lang）、duration、order。 注意：批量创建中的 due 是嵌套对象，与 CREATE_TASK 的扁平字段不同；同一批次可指向不同项目/分区。

常见模式

  • ID 解析：先按名称匹配项目 ID、分区 ID、任务 ID。
  • 分页：GET_ALL_TASKS 无需分页；已完成任务使用 cursor 分页；项目与分区无需分页。
  • 截止日期：自然语言用 due_string，具体日期用 due_date，具体日期时间用 due_datetime，一次只用一个 due 字段，重复任务用自然语言。

已知陷阱

  • ID 格式：任务与项目 ID 可能是数字或字母数字；部分工具仅接受数字 ID；响应可能同时含 id 与 v2_id，API 操作使用 id。
  • 优先级反转：API 1=普通、4=紧急；UI p1=紧急、p4=普通。
  • 筛选语法：必须引用真实实体；文本搜索用 search: 关键词；completed 筛选在 GET_ALL_TASKS 无效。
  • 速率限制：Todoist API 有速率限制，批量操作优先使用 BULK_CREATE_TASKS，并间隔快速连续请求。

快速参考

  • 列出所有项目：TODOIST_GET_ALL_PROJECTS
  • 获取项目：TODOIST_GET_PROJECT（project_id）
  • 创建项目：TODOIST_CREATE_PROJECT（name, color, view_style）
  • 更新项目：TODOIST_UPDATE_PROJECT（project_id, name, color）
  • 列出分区：TODOIST_GET_ALL_SECTIONS（project_id）
  • 创建分区：TODOIST_CREATE_SECTION（project_id, name, order）
  • 更新分区：TODOIST_UPDATE_SECTION（section_id, name）
  • 删除分区：TODOIST_DELETE_SECTION（section_id）
  • 获取所有任务：TODOIST_GET_ALL_TASKS（filter, ids）
  • 获取任务：TODOIST_GET_TASK（task_id）
  • 创建任务：TODOIST_CREATE_TASK（content, project_id, due_string, priority）
  • 批量创建任务：TODOIST_BULK_CREATE_TASKS（tasks 数组）
  • 更新任务：TODOIST_UPDATE_TASK（task_id, content, due_string）
  • 完成任务：TODOIST_CLOSE_TASK（task_id）
  • 重开任务：TODOIST_REOPEN_TASK（task_id）
  • 删除任务：TODOIST_DELETE_TASK（task_id）
  • 已完成任务：TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE（since, until）
  • 列出筛选器：TODOIST_LIST_FILTERS（sync_token）

适用场景

适合需要通过 MCP 自动化 Todoist 任务与项目管理的用户，尤其是批量创建任务、按筛选条件查询任务、管理项目与分区、以及获取已完成任务历史的场景。

限制

需要 Rube MCP 与有效的 Todoist OAuth 连接；筛选词必须引用真实存在的实体；已完成任务查询日期范围约 3 个月；API 存在速率限制；部分工具对字母数字 ID 可能返回 HTTP 400。