---

name: todoist-automation description: "通过 Rube MCP (Composio) 自动化 Todoist 任务管理、项目、分区、筛选和批量操作。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Todoist 自动化

通过 Composio 的 Todoist 工具包自动化 Todoist 操作，包括任务创建和管理、项目组织、分区管理、筛选和批量任务工作流。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 todoist 建立活跃的 Todoist 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应以验证 Rube MCP 可用
2. 使用工具包 todoist 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接未处于 ACTIVE 状态，按照返回的认证链接完成 Todoist OAuth
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 创建和管理任务

使用场景：用户想创建、更新、完成、重新打开或删除任务

工具调用顺序：

1. TODOIST_GET_ALL_PROJECTS - 列出项目以找到目标项目 ID [前置]
2. TODOIST_GET_ALL_SECTIONS - 列出项目内的分区以放置任务 [可选]
3. TODOIST_CREATE_TASK - 创建带内容、截止日期、优先级、标签的单个任务 [必需]
4. TODOIST_BULK_CREATE_TASKS - 一次请求创建多个任务 [替代方案]
5. TODOIST_UPDATE_TASK - 修改任务属性（内容、截止日期、优先级、标签）[可选]
6. TODOIST_CLOSE_TASK - 将任务标记为已完成 [可选]
7. TODOIST_REOPEN_TASK - 恢复之前已完成的任务 [可选]
8. TODOIST_DELETE_TASK - 永久删除任务 [可选]

CREATE_TASK 关键参数：

• content：任务标题（支持 markdown 和超链接）
• description：附加备注（不要在此放截止日期）
• project_id：字母数字项目 ID；省略则添加到收件箱
• section_id：字母数字分区 ID，用于在项目内放置
• parent_id：任务 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 格式 YYYY-MM-DDTHH:mm:ssZ
• labels：标签名称字符串数组
• duration + duration_unit：任务持续时间（如 30 + "minute"）

注意事项：

• 同一时间只能使用一个 due_* 字段（due_lang 除外，可与任何字段配合）
• 不要在 content 或 description 中嵌入截止日期——使用 due_string 字段
• 不要在 due_string 中嵌入持续时间短语如"for 30 minutes"——使用 duration + duration_unit
• API 中的 priority：1=普通，4=紧急（与 Todoist UI 显示相反，UI 中 p1=紧急）
• 任务 ID 可以是数字或字母数字；使用 API 返回的格式
• CLOSE_TASK 标记完成；DELETE_TASK 永久删除——它们是不同的操作

2. 管理项目

使用场景：用户想列出、创建、更新或查看项目

工具调用顺序：

1. TODOIST_GET_ALL_PROJECTS - 列出所有项目及元数据 [必需]
2. TODOIST_GET_PROJECT - 通过 ID 获取特定项目详情 [可选]
3. TODOIST_CREATE_PROJECT - 创建带名称、颜色、视图样式的新项目 [可选]
4. TODOIST_UPDATE_PROJECT - 修改项目属性 [可选]

关键参数：

• name：项目名称（创建时必需）
• color：Todoist 调色板颜色（如 "blue"、"red"、"green"、"charcoal"）
• view_style："list" 或 "board" 布局
• parent_id：父项目 ID，用于创建子项目
• is_favorite / favorite：布尔值，标记为收藏
• project_id：更新和获取操作必需

注意事项：

• 名称相似的项目可能导致选错 project_id；始终验证
• CREATE_PROJECT 使用 favorite 而 UPDATE_PROJECT 使用 is_favorite——字段名不同
• 使用 API 返回的项目 id，不是 v2_id，用于后续操作
• 字母数字/URL 样式的项目 ID 在某些工具中可能导致 HTTP 400；如有可用则使用数字 ID

3. 管理分区

使用场景：用户想使用分区在项目内组织任务

工具调用顺序：

1. TODOIST_GET_ALL_PROJECTS - 找到目标项目 ID [前置]
2. TODOIST_GET_ALL_SECTIONS - 列出现有分区以避免重复 [前置]
3. TODOIST_CREATE_SECTION - 在项目中创建新分区 [必需]
4. TODOIST_UPDATE_SECTION - 重命名现有分区 [可选]
5. TODOIST_DELETE_SECTION - 永久删除分区 [可选]

关键参数：

• project_id：目标项目 ID（创建时必需）
• name：分区名称
• section_id：更新/删除操作的分区 ID

注意事项：

• 删除分区会将其中的任务移到项目根级别，不会删除任务
• 分区在项目内按创建顺序排列