wrike-automation

通过 Rube MCP 自动化 Wrike

通过 Rube MCP 使用 Composio 的 Wrike 工具包自动执行 Wrike 项目管理操作。

工具包文档：composio.dev/toolkits/wrike

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过工具包 wrike 使用 RUBE_MANAGE_CONNECTIONS 建立有效的 Wrike 连接
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

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

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用
2. 使用工具包 wrike 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请使用返回的授权链接完成 Wrike OAuth
4. 运行任何工作流之前，确认连接状态显示为 ACTIVE

核心工作流

1. 创建和管理任务

适用场景：用户想要在 Wrike 中创建、分配或更新任务

工具调用顺序：

1. WRIKE_GET_FOLDERS - 查找目标文件夹/项目 [前置条件]
2. WRIKE_GET_ALL_CUSTOM_FIELDS - 如有需要，获取自定义字段 ID [可选]
3. WRIKE_CREATE_TASK - 创建新任务 [必需]
4. WRIKE_MODIFY_TASK - 更新任务属性 [可选]

关键参数：

• folderId：将创建任务的上级文件夹 ID
• title：任务标题
• description：任务描述（支持 HTML）
• responsibles：要分配任务的用户 ID 数组
• status：'Active'、'Completed'、'Deferred'、'Cancelled'
• importance：'High'、'Normal'、'Low'
• customFields：由 {id, value} 对象组成的数组
• dates：包含 type、start、due、duration 的对象

注意事项：

• folderId 为必填项；任务必须归属某个文件夹
• responsibles 需要 Wrike 用户 ID，不能使用电子邮件地址或姓名
• 必须通过 GET_ALL_CUSTOM_FIELDS 获取自定义字段 ID
• priorityBefore 和 priorityAfter 不能同时使用
• Team 计划可能不提供 Status 字段
• dates.start 和 dates.due 使用 'YYYY-MM-DD' 格式

2. 管理文件夹和项目

适用场景：用户想要创建、修改或整理文件夹和项目

工具调用顺序：

1. WRIKE_GET_FOLDERS - 列出现有文件夹 [必需]
2. WRIKE_CREATE_FOLDER - 创建新文件夹/项目 [可选]
3. WRIKE_MODIFY_FOLDER - 更新文件夹属性 [可选]
4. WRIKE_LIST_SUBFOLDERS_BY_FOLDER_ID - 列出子文件夹 [可选]
5. WRIKE_DELETE_FOLDER - 永久删除文件夹 [可选]

关键参数：

• folderId：创建时为上级文件夹 ID；修改时为目标文件夹 ID
• title：文件夹名称
• description：文件夹描述
• customItemTypeId：设置为项目类型，以创建项目而非文件夹
• shareds：要共享给的用户 ID 或电子邮件地址数组
• project：在 GET_FOLDERS 中筛选项目（true）或文件夹（false）

注意事项：

• DELETE_FOLDER 会永久删除文件夹及其所有内容（任务、子文件夹、文档）
• 不能将 rootFolderId 或 recycleBinId 设置为上级文件夹
• 创建文件夹时会自动与创建者共享
• customItemTypeId 会将文件夹转换为项目
• 使用 descendants=true 调用 GET_FOLDERS 会返回文件夹树（可能很大）

3. 检索和跟踪任务

适用场景：用户想查找任务、查看状态或跟踪进度

工具调用顺序：

1. WRIKE_FETCH_ALL_TASKS - 列出任务，可选择使用筛选条件［必需］
2. WRIKE_GET_TASK_BY_ID - 获取特定任务的详细信息［可选］

关键参数：

• status：按任务状态筛选（如 'Active'、'Completed' 等）
• dueDate：按截止日期范围筛选（开始／结束／相等）
• fields：要包含在响应中的其他字段
• page_size：每页结果数（1-100）
• taskId：用于获取详细信息的特定任务 ID
• resolve_user_names：自动将用户 ID 解析为姓名（默认值为 true）

注意事项：

• FETCH_ALL_TASKS 每页最多返回 100 项
• dueDate 筛选条件支持 'equal'、'start' 和 'end' 字段
• 日期格式：'yyyy-MM-dd' 或 'yyyy-MM-ddTHH:mm:ss'
• GET_TASK_BY_ID 返回只读的详细信息
• 查询单个任务时，默认会返回 customFields

4. 启动任务蓝图

适用场景：用户想根据预定义模板创建任务

工具调用顺序：

1. WRIKE_LIST_TASK_BLUEPRINTS - 列出可用蓝图［前置条件］
2. WRIKE_LIST_SPACE_TASK_BLUEPRINTS - 列出特定空间中的蓝图［替代方案］
3. WRIKE_LAUNCH_TASK_BLUEPRINT_ASYNC - 启动蓝图［必需］

关键参数：

• task_blueprint_id：要启动的蓝图 ID
• title：根任务的标题
• parent_id：父文件夹／项目 ID（或 super_task_id）
• super_task_id：父任务 ID（或 parent_id）
• reschedule_date：任务重新排期的目标日期
• reschedule_mode：'RescheduleStartDate' 或 'RescheduleFinishDate'
• entry_limit：要复制的任务数上限（1-250）

注意事项：

• 必须提供 parent_id 或 super_task_id，不能同时提供两者
• 蓝图以异步方式启动；任务可能需要一段时间才会显示
• 设置 reschedule_date 时必须同时设置 reschedule_mode
• entry_limit 将每次蓝图启动可复制的任务／文件夹数限制为最多 250 个
• copy_descriptions 默认为 false；设置为 true 可包含任务描述

5. 管理工作区和成员

适用场景：用户想管理空间、成员或邀请

工具调用顺序：

1. WRIKE_GET_SPACE - 获取空间详情［可选］
2. WRIKE_GET_CONTACTS - 列出工作区联系人／成员［可选］
3. WRIKE_CREATE_INVITATION - 邀请用户加入工作区［可选］
4. WRIKE_DELETE_SPACE - 永久删除空间［可选］

关键参数：

• spaceId：空间标识符
• email：用于邀请的电子邮件地址
• role：用户角色（'Admin'、'Regular User'、'External User'）
• firstName/lastName：受邀者姓名

注意事项：

• DELETE_SPACE 操作不可撤销，并会删除空间中的所有内容
• 在邀请中，userTypeId 与 role/external 不能同时使用
• 自定义电子邮件主题／消息需要付费 Wrike 计划
• GET_CONTACTS 返回工作区级联系人，而非特定任务的指派人员

常见模式

文件夹 ID 解析

1. Call WRIKE_GET_FOLDERS (optionally with project=true for projects only)
2. Navigate folder tree to find target
3. Extract folder id (e.g., 'IEAGKVLFK4IHGQOI')
4. Use as folderId in task/folder creation

自定义字段设置

1. Call WRIKE_GET_ALL_CUSTOM_FIELDS to get definitions
2. Find field by name, extract id and type
3. Format value according to type (text, dropdown, number, date)
4. Include as {id: 'FIELD_ID', value: 'VALUE'} in customFields array

任务分配

1. Call WRIKE_GET_CONTACTS to find user IDs
2. Use user IDs in responsibles array when creating tasks
3. Or use addResponsibles/removeResponsibles when modifying tasks

分页

• FETCH_ALL_TASKS：使用 page_size（最多 100）并检查是否有更多结果
• GET_FOLDERS：当 descendants=false 且设置了 pageSize 时，使用 nextPageToken
• LIST_TASK_BLUEPRINTS：使用 next_page_token 和 page_size（默认值为 100）

已知注意事项

ID 格式：

• Wrike ID 是不透明的字母数字字符串（例如，'IEAGTXR7I4IHGABC'）
• 任务 ID、文件夹 ID、空间 ID 和用户 ID 均使用此格式
• 自定义字段 ID 遵循相同格式
• 切勿猜测 ID；始终通过列表或搜索操作解析

权限：

• 操作取决于用户角色和共享设置
• 共享文件夹和任务仅对共享对象可见
• 管理员操作需要相应的角色
• 部分功能（自定义状态、计费类型）取决于套餐

删除安全性：

• DELETE_FOLDER 会永久删除所有内容
• DELETE_SPACE 会删除整个空间及其内容
• 可考虑使用 MODIFY_FOLDER 将其移至回收站
• 可通过设置 restore=true，使用 MODIFY_FOLDER 从回收站还原

日期处理：

• 日期使用 'yyyy-MM-dd' 格式
• 日期时间使用 'yyyy-MM-ddTHH:mm:ssZ' 格式，或使用带时区偏移的格式
• 任务日期包含类型（'Planned'、'Actual'）、开始时间、截止时间和时长
• 时长以分钟为单位

快速参考

任务	工具 Slug	关键参数
创建任务	WRIKE_CREATE_TASK	folderId, title, responsibles, status
修改任务	WRIKE_MODIFY_TASK	taskId, title, status, addResponsibles
按 ID 获取任务	WRIKE_GET_TASK_BY_ID	taskId
获取所有任务	WRIKE_FETCH_ALL_TASKS	status, dueDate, page_size
获取文件夹	WRIKE_GET_FOLDERS	project, descendants
创建文件夹	WRIKE_CREATE_FOLDER	folderId, title
修改文件夹	WRIKE_MODIFY_FOLDER	folderId, title, addShareds
删除文件夹	WRIKE_DELETE_FOLDER	folderId
列出子文件夹	WRIKE_LIST_SUBFOLDERS_BY_FOLDER_ID	folderId
获取自定义字段	WRIKE_GET_ALL_CUSTOM_FIELDS	(none)
列出蓝图	WRIKE_LIST_TASK_BLUEPRINTS	limit, page_size
启动蓝图	WRIKE_LAUNCH_TASK_BLUEPRINT_ASYNC	task_blueprint_id, title, parent_id
获取空间	WRIKE_GET_SPACE	spaceId
删除空间	WRIKE_DELETE_SPACE	spaceId
获取联系人	WRIKE_GET_CONTACTS	(none)
邀请用户	WRIKE_CREATE_INVITATION	email, role

---

由 Composio 提供支持