BambooHR MCP Server - Barndoor Documentation
BambooHR
SecureBarndoor Managed Finance & Accounting
Summary: Custom built connector to manage BambooHR company metadata, employees, reports, and time-off workflows via AI tools.
How Teams Use It: HR teams can use BambooHR MCP to manage employee data, time-off requests, reports, company information, and benefits through natural language AI interactions.
Tools
| Tool Name | Tool Description | Tool Type |
|---|---|---|
| create_employee | Create a new employee. At minimum, provide a first name and last name in a JSON object or XML document. The request body schema lists commonly used fields, but any valid employee field name may be included as a key. | Create |
| create_table_row | Add a new row to the specified employee table by submitting field name/value pairs in JSON or XML. Use this endpoint to append records to tabular employee data such as job information or compensation history. | Create |
| get_alignable_goal_options | Returns the list of goals that the specified employee's goal can be aligned with. | Read |
| get_break | Retrieves a single time tracking break by its UUID. Returns the full break details including name, duration, paid status, and availability configuration. | Read |
| get_break_policy | Retrieves a single break policy by its UUID. When includeCounts is enabled, the response includes the number of associated employees and breaks. | Read |
| get_changed_employee_table_data | Returns table data for employees that have changed since the given timestamp. This is an optimization to avoid downloading all table data for all employees. | Read |
| get_company_file | Downloads a company file by its ID. The response body is the raw file content. The Content-Type header reflects the file's MIME type and Content-Disposition is set to attachment with the original filename. | Read |
| get_company_information | Returns basic profile information for the company, including its legal name, display name, primary address, and contact phone number. | Read |
| get_company_profile_integrations | Returns the list of integration feature identifiers currently enabled for the company. Each identifier is an uppercase string key (e.g. BAMBOOHR_PAYROLL, TIME_TRACKING, E_SIGNATURES) representing a product feature or integration. |
Read |
| get_company_report | Deprecated. Use Custom Reports > Get Report by ID instead. Returns the data from an existing saved custom report. |
Read |
| get_data_from_dataset_v1 | Deprecated. Use "Get Data from Dataset (v2)" instead. Retrieves records from the specified dataset using the fields, filters, sorting, grouping, and aggregations supplied in the request body. Provide field names in the fields array; use "Get Fields from Dataset (v1.2)" to discover available names |
Read |
| get_data_from_dataset_v2 | Queries the specified dataset and returns matching records. Each row in the data array wraps its values under a fields object. The response also includes links for pagination navigation and meta with page number, page size, and total counts. |
Read |
| get_employee | Returns employee data for the specified employee ID. Specify which fields to return using the fields query parameter (comma-separated list of field names). |
Read |
| get_employee_dependent | Returns the details of a single employee dependent by their dependent ID. The response is a JSON object with a top-level key "Employee Dependents" containing a single-element array. | Read |
| get_employee_file | Downloads the binary content of an employee file as an attachment. The response Content-Type header reflects the file's stored MIME type (e.g. application/pdf) and includes a Content-Disposition header with the original filename. | Read |
| get_employee_photo | Returns an employee photo at the requested size. Available sizes are: original (full resolution), large (340×340), medium (170×170), small (150×150), xs (50×50), and tiny (20×20). | Read |
| get_employee_table_data | Returns all rows for a given employee and table combination. Each row contains the fields defined for that table, subject to field-level permission checks. | Read |
| get_employees_directory | Returns the company employee directory, including a fieldset definition and an array of employee records. Only returns employees with an employee status of 'Active'. | Read |
| get_fields_from_dataset_v1 | Deprecated. Use "Get Fields from Dataset (v1.2)" instead. Returns a paginated list of field descriptors for the specified dataset. Each field includes its machine-readable name, human-readable label, parentType, parentName, and entityName. |
Read |
| get_fields_from_dataset_v1_2 | Returns a paginated list of field descriptors for the specified dataset. Each field includes its machine-readable name, human-readable label, parent section type and name, and entityName. |
Read |