BambooHR MCP server for your AI

Create a goal for an employee (201 returns the goal).

List an employee's performance goals (returns {goals:[...]}).

Update a goal (v1).

Create a new training record for the specified employee (employeeId is a PATH param, not a body field).

List all training records for a specific employee.

List all training types configured for the company.

Create (add) a new employee.

List employee IDs that changed since a timestamp.

Get a single employee by ID.

Get the company employee directory: all employees the caller can see, with the set of fields enabled for the directory.

List employees as a cursor-paginated collection.

Update an existing employee (partial/PATCH-style).

Create a time off request for an employee (PUT, no trailing slash).

Update (approve/deny/cancel) the status of an existing time off request (PUT).

Estimate/calculate an employee's time off balances as of a date (the 'calculator' / future-balance projection).

Get a date-sorted list of who is out (employee time off) plus company holidays for a period.

List time off requests overlapping a date window.

Update the status of a job application.

Get the full details of a single job application by ID: applicant info (name, contact, address, education, social profiles), job/position details, status with full change history, custom questions and answers, attachments metadata (resume, cover letter as file IDs), application history, ratings, comments, emails, events, references, and desired salary.

Execute a saved custom report by its integer id and return its data using the report's configured fields and filters.

List job applications (candidates) in the ATS.

List all company file categories and the file metadata within each that the caller may see.

List saved custom reports available in the account.

DEPRECATED v1.

List an employee's file categories and the file metadata within each.

List job opening summaries from the ATS.

DEPRECATED v1 (v2 successor is POST /api/v2/datasets/{datasetName}/data, outside the /v1/ base — see notes).

List every employee field available in the account (standard + custom).

List the tabular (history-table) fields available in the account, e.g.

List the time off policies configured in the account, each with its id, associated time-off type id, name, and accrual/eligibility configuration.

List the time off types configured in the account (e.g.

Create a new event-based (permissioned) webhook.

List the employee fields that can be monitored by a webhook (used to choose monitorFields when creating/updating).

List all webhooks owned by the authenticated API user (event-based / permissioned webhooks).

Add (append) a new row to a tabular employee data table by submitting field name/value pairs (JSON or XML).

Get all rows of a tabular (two-dimensional / time-series) employee data table for one employee.

Update an existing row in a tabular employee data table by submitting the field name/value pairs to change (JSON or XML).

Add a single time tracking hour record (legacy Hours API).

Adjust/edit an existing time tracking hour record (legacy Hours API).

Assign (add) employees to a break policy without removing existing assignments.

Bulk add/edit time tracking hour records (legacy Hours API).

Clock in an employee (Time Tracking add-on timesheets).

Clock out a currently clocked-in employee (Time Tracking add-on timesheets).

Create a new break and associate it with the specified break policy.

Create a break policy.

Generate AI break-policy recommendations.

Create a time tracking project.

Create a new task on the specified time tracking project.

Create a time tracking shift differential.

Delete a time tracking break by its UUID.

Delete a break policy by its UUID.

Delete one or more timesheet clock entries by ID (Time Tracking add-on).

Delete one or more timesheet hour entries by ID (Time Tracking add-on).

Delete a time tracking hour record by its id (legacy Hours API).

Delete a time tracking project by its ID.

Delete a time tracking task by its ID.

Delete a time tracking shift differential by its ID.

Retrieve a single time tracking break by its UUID.

Retrieve a single break policy by its UUID.

Retrieve a single time tracking hour record by its ID (legacy Hours API).

Retrieve a single time tracking project by its ID, including the list of assigned employees.

Retrieve a single time tracking task by its ID.

Retrieve a single time tracking shift differential by its ID.

List break assessments (paginated).

List all break policies (paginated).

List the breaks belonging to a break policy (paginated).

List employees assigned to a specific break policy (paginated).

Retrieve break availability information for an employee.

Retrieve break policies assigned to a specific employee.

List tasks for a time tracking project (paginated).

List time tracking projects (paginated).

List time tracking shift differentials (paginated).

List timesheet entries for all employees or a filtered subset within a date range (Time Tracking add-on).

Replace all breaks for a break policy.

Set (replace) the employee assignments for a break policy.

Bulk create or update timesheet clock entries (Time Tracking add-on).

Bulk create or update timesheet hour entries (Time Tracking add-on).

Full replacement of a break policy and its related data (breaks and employee assignments).

Unassign the specified employees from a break policy (removes their assignments without affecting the policy or other employees).

Partially update a time tracking break by its UUID (only provided fields change).

Partially update a break policy by its UUID (only provided fields change).

Partially update a time tracking project by ID (only provided fields change).

Partially update a time tracking task by ID (at least one field required).

Partially update a time tracking shift differential by ID.

Close a goal, moving it to closed status (201 returns the updated goal).

Delete a single comment from a goal.

Check whether the current API user is permitted to create goals for this employee.

Get a single goal with its full detail in one request: the goal plus its comments, alignment options, and the list of all persons who are shared on the goal or have commented on it.

List the options a goal can be aligned with for this employee (company/team/manager goals).

List the comments on a goal.

List the available people/options a goal can be shared with for this employee.

Get aggregate goal info for an employee in one call: the list of all goals, type counts, goal comment counts, and employees shared with goals.

Reopen a previously closed goal, returning it to an active status.

Update the progress of a single milestone within a milestone-based goal.

Update the completion percentage of a simple (non-milestone) goal.

Update who a goal is shared with.

Create a new training category.

Create a new training type.

Delete an existing employee training record by record ID (path takes the training record ID, not the employee ID; no 'employee/' segment).

Delete an existing training category by ID.

Delete an existing training type by ID.

List all training categories for the company.

Update an existing employee training record by record ID (NOTE: the path takes the training record ID, NOT the employee ID, and has no 'employee/' segment).

Update the name of an existing training category by ID.

Update an existing training type by ID.

Create an employee dependent.

Permanently delete an employee record and all associated data.

Get a single employee dependent by its numeric dependent ID.

List employee dependents.

Update an employee dependent by numeric dependent ID (full replace).

Create a time off history item for an employee (used time or balance override).

Add a balance adjustment for an employee's time off type (recorded as an override history item).

Assign time off policies to an employee (PUT).

List the time off policies currently assigned to a specific employee.

Add a comment to a job application.

Create one or more company file categories (sections).

Create one or more employee file categories (sections).

Permanently delete a company file (irreversible).

Permanently delete an employee file (irreversible).

DEPRECATED (BambooHR says use Custom Reports > Get Report by ID, i.e.

DEPRECATED v1.

DEPRECATED v1.

List the applicant/application statuses configured for the company.

List company locations available for use in job opening creation.

List the employees who can be assigned as a hiring lead on a job opening.

DEPRECATED (BambooHR says use Datasets > Get Data from Dataset, i.e.

Update metadata for an existing company file: rename it, move it to another category, or toggle employee visibility.

Update metadata for an existing employee file: rename it, move it to another category, or toggle employee visibility.

Get details for all list/multi-select fields in the account.

List all BambooHR users (login accounts) in the account, keyed by user id, with employeeId, firstName, lastName, email, status, and lastLogin.

Add, update, or archive the option values of a single manageable list field.

Delete a webhook by id.

Get the full configuration of a single webhook owned by the authenticated user, including name, url, format, monitored fields (monitorFields) and post fields (postFields) when applicable, events, creation datetime, and last-sent datetime.

List all benefit coverage levels configured in the company (e.g.

List all payroll benefit deduction types available in the system.

List all active (non-deleted) company benefit plans for the account with summary-level info: plan name, category/type, vendor and deduction IDs, effective dates, and catch-up eligibility flags.

List current and scheduled-future benefit enrollment records grouped by employee: enrollment status, deduction date ranges, currency, occurrences per year, cost-sharing details, and annual maximums.

List benefit coverage events for all members (employees and dependents).

List a paginated set of benefit enrollment records for all company members (employees and dependents) for a given calendar year, showing plan enrollments and the date ranges/statuses during which each was held.

Update (full replacement) a webhook by id.

Delete a specific row from an employee's tabular data table.

Get tabular table data for all employees that has CHANGED since a given timestamp (an optimization to avoid downloading every employee's full table).