Bamboohr
BambooHR is an American technology company that provides human resources software as a service.
VIEWS
814
USERS
47
CATEGORY
ERP
VERSION
Install MCP Server
Paste and run this command in your terminal to set up Cursor with MCP
After running the command, restart Cursor to start using the MCP Server.
Available Tools
Add Benefit Group Employee Record
This endpoint allows you to associate an employee with a specific benefit group in bamboohr for a defined period. it's used when you need to enroll an employee in a new benefits package or update their existing benefits enrollment. the association can be set for a specific time frame or left open-ended for ongoing enrollment. this tool is particularly useful for hr administrators managing employee benefits, especially during onboarding, annual enrollment periods, or when an employee's benefit status changes. note that this endpoint only creates the association; it doesn't provide details about the benefits themselves or handle the actual enrollment process in specific benefit plans.
Create Employee Benefit Entry
Creates or updates an employee benefit in the bamboohr system. this endpoint allows you to manage various aspects of an employee's benefit enrollment, including coverage details, financial contributions, and enrollment status. it's primarily used when setting up new benefits for an employee, making changes to existing benefits, or updating enrollment statuses. the endpoint is versatile, handling different types of benefits with various contribution structures for both employees and the company. it's important to note that while many fields are optional, they may be required depending on the specific benefit type and company policies. this endpoint should not be used for bulk updates or to retrieve benefit information; separate endpoints likely exist for those purposes.
Create Employee Dependent Record
This endpoint allows you to create a new dependent for an existing employee in the bamboohr system. it is used to add family members or other individuals who are dependent on the employee, which is crucial for benefits administration, tax purposes, and other hr-related tasks. the endpoint requires detailed information about the dependent, including personal details, contact information, and status indicators. it should be used when onboarding new employees with dependents, updating family information, or managing benefits enrollment periods. note that some fields contain sensitive personal information, so ensure proper data security measures are in place when using this endpoint.
Modify Employee Withholding Details
This endpoint updates an employee's withholding information for tax purposes in the bamboohr system. it allows modification of federal, state, and local tax withholding amounts, including any additional withholdings, as well as specifying the applicable tax state and local jurisdiction. this tool should be used when there are changes to an employee's tax situation, such as filing status changes, additional jobs, or relocation. it's crucial for maintaining accurate payroll calculations and tax compliance. the endpoint doesn't calculate tax amounts; it only updates the stored values based on the provided information. users should ensure they have the correct withholding information before making updates, as incorrect data may lead to under or over-withholding of taxes.
Create Employee Direct Deposit Account
Updates the direct deposit account information for a specific employee in the bamboohr system. this endpoint allows you to modify existing direct deposit accounts or add new ones for an employee. it's particularly useful when an employee changes their bank account, adjusts their deposit allocations, or wants to split their paycheck across multiple accounts. the endpoint requires the company domain and employee id in the url path, and accepts an array of account objects in the request body, each detailing the specifics of a direct deposit account. this tool should be used with caution as it directly affects an employee's payment method, and any errors could result in payroll issues.
Post Employee Paystub Details
Creates a new employee pay stub in the bamboohr system. this endpoint allows for the detailed recording of an employee's pay information for a specific pay period, including gross and net pay, taxes, deductions, and direct deposit allocations. it should be used when processing payroll to maintain accurate financial records for each employee. the endpoint captures both current pay period data and year-to-date totals, providing a comprehensive view of an employee's earnings and deductions. it's particularly useful for integrating external payroll systems with bamboohr, ensuring that hr records are synchronized with actual payroll data. note that this endpoint does not process actual payments; it only records the pay stub information in the bamboohr system.
Create Employee Unpaid Paystub
Posts unpaid pay stubs for a specific employee in the bamboohr system. this endpoint allows you to add or update information about pay periods for which an employee has not been paid. it's useful for tracking delayed payments, managing payroll discrepancies, or recording periods of unpaid leave. the function requires the employee's id and an array of unpaid period dates. use this when you need to update an employee's payroll record with periods that haven't been compensated yet. note that this endpoint doesn't process payments; it only records the unpaid periods for tracking and future processing.
Create Company Benefit
This endpoint creates a new company benefit in bamboohr. it allows hr administrators to set up various types of employee benefits, including health insurance, retirement plans, and reimbursement programs. the endpoint captures essential details such as benefit type, start and end dates, deduction information, and compliance with aca requirements. use this endpoint when adding a new benefit offering or updating an existing benefit with new terms. it's particularly useful during open enrollment periods or when changing benefit providers. note that this endpoint does not enroll employees in the benefit; it only sets up the benefit at the company level.
Add Time Tracking Record
This endpoint allows you to add a new time tracking record for an employee in the bamboohr system. it's used to log hours worked, including regular and overtime hours, along with associated details such as pay rates, job codes, and organizational information. the endpoint is essential for accurate time tracking, payroll processing, and reporting within bamboohr. use this when you need to manually input or programmatically add time entries for employees, ensuring that all required fields are provided and optional fields are included as needed for your specific payroll and reporting requirements.
Post Applicant Comment
This endpoint allows you to post a comment on a specific application in bamboohr's applicant tracking system. it's used to add notes, feedback, or any relevant information to an applicant's file during the recruitment process. the endpoint requires the company domain and application id to identify where the comment should be added, along with the comment text itself. it's particularly useful for collaboration among hiring team members, documenting interview feedback, or noting important details about an applicant. this function should be used whenever there's a need to update an application with new information in a comment format. note that this endpoint only handles adding comments and does not provide functionality for reading or modifying existing comments.
Update Employee Time Off History
Adds a new time off history item to an employee's record in bamboohr. this endpoint is used to retroactively add time off requests to an employee's history, which is useful for maintaining accurate records of past time off, especially when backfilling data or correcting historical entries. it allows hr administrators to ensure that an employee's time off history is complete and up-to-date, which is crucial for accurate leave balance calculations and reporting. the endpoint requires the company domain and employee id to be specified in the url path, ensuring that the time off history item is added to the correct employee's record.
Request Employee Time Off
This endpoint allows you to add or update a time off request for a specific employee in bamboohr. it's used to submit new time off requests or modify existing ones, providing detailed information about the request such as start and end dates, type of time off, and any associated notes. this tool is essential for managing employee leave and maintaining accurate records of time off within the bamboohr system. it should be used whenever an employee needs to request time off or when hr needs to update an existing time off request. the endpoint doesn't handle approval workflows directly; it's primarily for creating and updating request data.
Store Time Tracking Clock Entries
The "store time tracking clock entries" endpoint allows you to create or update multiple time tracking entries for employees in bamboohr. this endpoint is used to record working hours, including start and end times, dates, and optional project, task, and note information. it's particularly useful for batch processing of time entries, such as at the end of a pay period or when synchronizing data from another system. use this endpoint when you need to add new time entries or modify existing ones in bulk. it supports creating new entries and updating existing ones by specifying the entry id. the endpoint is designed for efficiency, allowing multiple entries to be processed in a single api call. note that this endpoint does not handle time entry approval workflows or payroll calculations directly. it's primarily for data entry and updates. ensure that the employee ids, project ids, and task ids used in the request correspond to valid entities in your bamboohr system to avoid errors.
Store Hour Entries
This endpoint allows you to store or update multiple time tracking hour entries for employees in bamboohr. it's designed for bulk creation or modification of timesheet entries, enabling efficient management of employee work hours, project time allocation, and task tracking. use this endpoint when you need to submit time entries for one or more employees, associate work hours with specific projects or tasks, or update existing time entries. the endpoint is particularly useful for integrating external time tracking systems with bamboohr or for automating the process of time entry submission. note that while you can create multiple entries in a single request, each entry must contain the required fields (employeeid, date, and hours) to be valid. optional fields allow for more detailed time tracking and management capabilities.
Create New Employee
Creates a new employee record in the bamboohr system. this endpoint allows you to add a new employee to your company's hr database by providing essential information such as first name and last name. it's typically used when onboarding new hires or adding existing employees to the bamboohr system for the first time. the endpoint supports additional properties beyond the required fields, allowing for flexible and comprehensive employee data entry. however, it's important to note that this endpoint only initiates the employee record and may not include all possible employee information fields available in bamboohr.
Submit Candidate Application
This endpoint creates a new job application in the bamboohr applicant tracking system. it allows for the submission of a candidate's personal information, professional details, and supporting documents for a specific job opening. the endpoint accepts multipart/form-data, enabling the upload of resume and cover letter files along with text-based information. it should be used when a new candidate applies for a job or when bulk-uploading applications from external sources. the endpoint requires at minimum the candidate's first name, last name, and the job id, but allows for a comprehensive application with optional fields covering everything from contact details to educational background.
Post Employee Training Record
This endpoint allows you to create a new training record for a specific employee in the bamboohr system. it's used to document completed training sessions, including details such as the completion date, cost, instructor, duration, credits earned, and any additional notes. this tool is essential for maintaining accurate employee development records, tracking professional growth, and ensuring compliance with training requirements. it should be used whenever an employee completes a training session, workshop, or course that needs to be officially recorded in their hr file. the endpoint requires the company domain and employee id as part of the url, ensuring that the training record is associated with the correct employee in the appropriate company account.
Create Job Opening Post
Creates a new job opening in the bamboohr applicant tracking system. this endpoint allows you to set up a comprehensive job listing with detailed information about the position, requirements, and application process. use this when you need to post a new job opportunity, whether it's ready to be published or still in draft form. the endpoint captures essential job details and allows customization of the application form through various question fields. it's particularly useful for hr managers and recruiters who need to efficiently manage the hiring process. note that while you can create a job opening, this endpoint does not automatically publish or advertise the position; additional steps may be required to make the job visible to potential applicants.
Add Or Update List Field Values
Adds new values or updates existing values for a specific list field in the bamboohr system. this endpoint allows you to modify the available options for custom dropdown fields, multi-select fields, or other list-type fields in your bamboohr instance. it's particularly useful when you need to maintain consistent list options across your hr system, such as updating department names, job titles, or any other predefined lists used in employee records or forms. the endpoint requires the company domain and the specific list field id to be included in the url path, ensuring changes are applied to the correct field in the right company instance.
Update Employee Table Row
This endpoint allows you to update a specific row in an employee's table within bamboohr. it is used to modify various aspects of an employee's record, such as their job information, location, or organizational structure. the endpoint is particularly useful for keeping employee data up-to-date when changes occur, such as promotions, transfers, or organizational restructuring. it's important to note that this endpoint updates a single row in a specific table, so multiple calls may be necessary for comprehensive employee record updates across different tables.
20 actions available