bamboohr-automation

1# BambooHR Automation via Rube MCP
2 
3Automate BambooHR human resources operations through Composio's BambooHR toolkit via Rube MCP.
4 
5**Toolkit docs**: [composio.dev/toolkits/bamboohr](https://composio.dev/toolkits/bamboohr)
6 
7## Prerequisites
8 
9- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
10- Active BambooHR connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `bamboohr`
11- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas
12 
13## Setup
14 
15**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
16 
17 
181. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
192. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `bamboohr`
203. If connection is not ACTIVE, follow the returned auth link to complete BambooHR authentication
214. Confirm connection status shows ACTIVE before running any workflows
22 
23## Core Workflows
24 
25### 1. List and Search Employees
26 
27**When to use**: User wants to find employees or get the full employee directory
28 
29**Tool sequence**:
301. `BAMBOOHR_GET_ALL_EMPLOYEES` - Get the employee directory [Required]
312. `BAMBOOHR_GET_EMPLOYEE` - Get detailed info for a specific employee [Optional]
32 
33**Key parameters**:
34- For GET_ALL_EMPLOYEES: No required parameters; returns directory
35- For GET_EMPLOYEE:
36  - `id`: Employee ID (numeric)
37  - `fields`: Comma-separated list of fields to return (e.g., 'firstName,lastName,department,jobTitle')
38 
39**Pitfalls**:
40…