---

name: bamboohr-automation description: "通过 Rube MCP（Composio）自动化 BambooHR 任务：员工、休假、福利、家属、员工更新。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 BambooHR 自动化

通过 Composio 的 BambooHR 工具包经由 Rube MCP 自动化 BambooHR 人力资源操作。

前提条件

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

设置

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

1. 通过确认 RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 可用
2. 使用工具包 bamboohr 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 BambooHR 认证
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 列出和搜索员工

何时使用：用户想要查找员工或获取完整的员工目录

工具序列：

1. BAMBOOHR_GET_ALL_EMPLOYEES - 获取员工目录 [必需]
2. BAMBOOHR_GET_EMPLOYEE - 获取特定员工的详细信息 [可选]

关键参数：

• GET_ALL_EMPLOYEES：无必需参数；返回目录
• GET_EMPLOYEE：
  • id：员工 ID（数字）
  • fields：逗号分隔的返回字段列表（例如 'firstName,lastName,department,jobTitle'）

注意事项：

• 员工 ID 是数字整数
• GET_ALL_EMPLOYEES 返回基本目录信息；使用 GET_EMPLOYEE 获取完整详情
• fields 参数控制返回哪些字段；省略可能返回最少数据
• 常用字段：firstName、lastName、department、division、jobTitle、workEmail、status
• 不活跃/已离职的员工可能包含在内；检查 status 字段

2. 跟踪员工变更

何时使用：用户想要检测最近的员工数据变更以进行同步或审计

工具序列：

1. BAMBOOHR_EMPLOYEE_GET_CHANGED - 获取最近有变更的员工 [必需]

关键参数：

• since：用于变更检测阈值的 ISO 8601 日期时间字符串
• type：要检查的变更类型（例如 'inserted'、'updated'、'deleted'）

注意事项：

• since 参数是必需的；使用 ISO 8601 格式（例如 '2024-01-15T00:00:00Z'）
• 返回已变更员工的 ID，而非完整员工数据
• 必须为每个已变更员工单独调用 GET_EMPLOYEE 获取详情
• 适用于增量同步工作流；缓存上次同步时间戳

3. 管理休假

何时使用：用户想要查看休假余额、申请休假或管理休假请求

工具序列：

1. BAMBOOHR_GET_META_TIME_OFF_TYPES - 列出可用的休假类型 [前提]
2. BAMBOOHR_GET_TIME_OFF_BALANCES - 检查当前余额 [可选]
3. BAMBOOHR_GET_TIME_OFF_REQUESTS - 列出现有请求 [可选]
4. BAMBOOHR_CREATE_TIME_OFF_REQUEST - 提交新请求 [可选]
5. BAMBOOHR_UPDATE_TIME_OFF_REQUEST - 修改或批准/拒绝请求 [可选]

关键参数：

• 余额查询：employeeId、休假类型 ID
• 请求查询：start、end（日期范围）、employeeId
• 创建请求：
  • employeeId：申请休假的员工
  • timeOffTypeId：来自 GET_META_TIME_OFF_TYPES 的类型 ID
  • start：开始日期（YYYY-MM-DD）
  • end：结束日期（YYYY-MM-DD）
  • amount：天数/小时数
  • notes：请求的可选备注
• 更新请求：requestId、status（'approved'、'denied'、'cancelled'）

注意事项：

• 休假类型 ID 是数字；先通过 GET_META_TIME_OFF_TYPES 解析
• 日期格式为 'YYYY-MM-DD'
• 余额可能以小时或天为单位，取决于公司配置
• 请求状态更新需要适当的权限（经理/管理员）
• 创建请求不会自动批准；需要单独的批准步骤

4. 更新员工信息

何时使用：用户想要修改员工档案数据

工具序列：

1. BAMBOOHR_GET_EMPLOYEE - 获取当前员工数据 [前提]
2. BAMBOOHR_UPDATE_EMPLOYEE - 更新员工字段 [必需]

关键参数：

• id：员工 ID（数字，必需）
• 要更新的字段值对（例如 department、jobTitle、workPhone）

注意事项：

• 只有请求中包含的字段会被更新；其他保持不变
• 某些字段是只读的，无法通过 API 更新
• 字段名必须与 BambooHR 期望的字段名完全匹配
• 更新会被审计；变更出现在员工的变更历史中
• 更新前使用 GET_EMPLOYEE 验证当前值以避免覆盖

5. 管理家属和福利

何时使用：用户想要查看员工家属或福利覆盖范围

工具序列：

1. BAMBOOHR_DEPENDENTS_GET_