Bamboohr Integration for AI Agents
Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Bamboohr MCP or direct API to fetch employee records, manage PTO, onboard new hires, and update HR data through natural language.
BambooHR is a cloud-based HR management platform for small and mid-sized businesses. It streamlines employee data, HR workflows, and reporting in one easy interface.
Category
hr & recruiting
159 TOOLS
oauth2api key
Supported Tools
Tools
Add benefit group employee recordThis endpoint allows you to associate an employee with a specific benefit group in bamboohr for a defined period.
Create employee benefit entryCreates or updates an employee benefit in the bamboohr system.
Create employee dependent recordThis endpoint allows you to create a new dependent for an existing employee in the bamboohr system.
Modify employee withholding detailsThis endpoint updates an employee's withholding information for tax purposes in the bamboohr system.
Create employee direct deposit accountUpdates the direct deposit account information for a specific employee in the bamboohr system.
Post employee paystub detailsCreates a new employee pay stub in the bamboohr system.
Create employee unpaid paystubPosts unpaid pay stubs for a specific employee in the bamboohr system.
Create company benefitThis endpoint creates a new company benefit in bamboohr.
Add time tracking recordThis endpoint allows you to add a new time tracking record for an employee in the bamboohr system.
Post applicant commentThis endpoint allows you to post a comment on a specific application in bamboohr's applicant tracking system.
Update employee time off historyAdds a new time off history item to an employee's record in bamboohr.
Request employee time offThis endpoint allows you to add or update a time off request for a specific employee in bamboohr.
Store time tracking clock entriesThe "store time tracking clock entries" endpoint allows you to create or update multiple time tracking entries for employees in bamboohr.
Store hour entriesThis endpoint allows you to store or update multiple time tracking hour entries for employees in bamboohr.
Create new employeeCreates a new employee record in the bamboohr system.
Submit candidate applicationThis endpoint creates a new job application in the bamboohr applicant tracking system.
Post employee training recordThis endpoint allows you to create a new training record for a specific employee in the bamboohr system.
Create job opening postCreates a new job opening in the bamboohr applicant tracking system.
Add or update list field valuesAdds new values or updates existing values for a specific list field in the bamboohr system.
Update employee table rowThis endpoint allows you to update a specific row in an employee's table within bamboohr.
Employee clock in via taskidClocks in an employee in the bamboohr time tracking system, marking the start of their work period.
Post employee clock outThis endpoint clocks out an employee in the bamboohr time tracking system, marking the end of their working hours.
Post training category via domainCreates a new training category in the bamboohr system.
Post training object for a company domainCreates a new training type in the bamboohr system with specified attributes and settings.
Add webhook with monitoring fieldsThe addwebhook endpoint allows you to create a new webhook in bamboohr, enabling real-time notifications for specific employee data changes.
Adjust employee time off balanceThis endpoint allows you to adjust the time off balance for a specific employee in bamboohr.
Fetch goal alignment optionsRetrieves the available goal alignment options for a specific employee or the authenticated api user in bamboohr.
Approve timesheets with timestampThe approvetimesheets endpoint enables managers or authorized personnel to approve multiple employee timesheets in a single api call within the bamboohr time tracking system.
Approve timesheets for employees that are currently clocked inThis endpoint will approve all timesheets for employees that are currently clocked in.
Retrieve employee performance optionsRetrieves the list of employees with whom a specific employee's goals can be shared within bamboohr.
Check employee goal creation permissionThis endpoint checks whether a specific employee has the permission to create goals within the bamboohr performance management system.
Post application status updateUpdates the status of a specific application in the bamboohr applicant tracking system.
Update time off request statusThis endpoint updates the status of a specific time-off request in bamboohr.
Delete employee withholding by idDeletes a specific employee withholding record from the bamboohr system.
Delete employee direct deposit accountsDeletes a specific direct deposit account associated with an employee in the bamboohr system.
Delete employee unpaid pay stubThis endpoint deletes a specific unpaid pay stub for an employee in the bamboohr system.
Clock in employee with time and locationThis endpoint records a clock-in event for a specific employee in the bamboohr time tracking system.
Post employee clock out datetimeThis endpoint records the clock-out time for a specific employee in the bamboohr time tracking system.
Clock out employee with locationThe clockoutemployee endpoint allows you to record an employee's clock-out time and location in the bamboohr time tracking system.
Close employee goalThe closeemployeegoal endpoint allows you to mark a specific performance goal as completed or closed for an individual employee in bamboohr.
Create time tracking projectCreates a new time tracking project in bamboohr.
Add employee goalThis endpoint allows you to add a new goal for a specific employee in the bamboohr performance management system.
Add comment to employee goalThis endpoint allows you to post a comment on a specific employee's goal within the bamboohr performance management system.
Delete company benefit by idDeletes a specific company benefit from the bamboohr system.
Delete employee pay stub by idDeletes a specific employee pay stub from the bamboohr system.
Delete time tracking entryThe deletetimetrackingentry endpoint allows for the deletion of a specific time tracking entry from the bamboohr system.
Delete clock entry idsDeletes multiple clock entries from the bamboohr time tracking system.
Delete file by idDeletes a specific file from the bamboohr system for a given company.
Delete employee file by idDeletes a specific file associated with an employee in the bamboohr system.
Delete employee training recordDeletes a specific employee training record from the bamboohr system.
Delete employee goalThis endpoint deletes a specific goal associated with an employee in the bamboohr performance management system.
Delete employee goal commentDeletes a specific comment on an employee's performance goal in the bamboohr system.
Delete employee table rowThis endpoint deletes a specific row from an employee's table in bamboohr.
Delete clock entries via idsDeletes multiple clock entries from the bamboohr time tracking system.
Delete hour entries by idsDeletes multiple time tracking hour entries from the bamboohr system.
Delete training categoryDeletes a specific training category from the bamboohr system for a given company.
Delete training type by idDeletes a specific training type from the bamboohr system.
Delete webhook by idThe deletewebhook endpoint is used to remove a specific webhook from the bamboohr system.
Adjust time tracking hoursThis endpoint allows you to adjust existing time tracking records in bamboohr.
Edit Current Clock In EntryThis endpoint allows an employee to clock in and record their work start time in the bamboohr time tracking system.
Post employee table row updateUpdates a specific row in a custom table for an individual employee in bamboohr.
Calculate employee time offRetrieves the time off calculator information for a specific employee in bamboohr.
Get employee clock entriesRetrieves a specific clock entry for an employee from the bamboohr time tracking system.
Retrieve company benefit by idRetrieves detailed information about a specific company benefit offered by an organization using bamboohr.
Get employee daily entriesRetrieves a specific daily time tracking entry for an employee in bamboohr.
Get employee goal aggregateRetrieves aggregated performance data for a specific employee's goal within the bamboohr system.
Retrieve company benefitsRetrieves a comprehensive list of company-wide benefits offered by the organization as configured in bamboohr.
Retrieve company benefit typeRetrieves a list of company benefit types available in the specified bamboohr company account.
Retrieve employee benefit filtersRetrieves employee benefit information based on specified filters.
Retrieve meta fields for domainRetrieves metadata about available fields in the bamboohr api for a specific company.
Retrieve meta tables for companydomainRetrieves metadata information about the tables available in the bamboohr system for a specific company.
Retrieve user meta informationRetrieves metadata about users within a specific company's bamboohr instance.
Get whos out for companyRetrieves a list of employees who are currently out of office or on leave within your organization.
Aggregate employee goals by idRetrieves aggregated goal information for a specific employee within a company's bamboohr system.
Aggregate employee goalsRetrieves aggregated performance goal data for a specific employee within a company's bamboohr system.
Aggregate employee goalsRetrieves aggregated information about an employee's goals within the bamboohr performance management system.
Retrieve employee dependents by company domainRetrieves a list of dependents for all employees in the company.
Retrieve file by idRetrieves a specific employee file from the bamboohr system.
Retrieve employee file by idRetrieves a specific file associated with an employee from the bamboohr system.
Fetch employee photo by sizeRetrieves an employee's photo from the bamboohr system in a specified size.
Fetch employee withholding by idRetrieves the withholding information for a specific employee within a company's bamboohr system.
Retrieve employee direct deposit account by idRetrieves detailed information about a specific employee's direct deposit account within a bamboohr company instance.
Fetch employee pay stub by idRetrieves detailed pay stub information for a specific employee within a company's bamboohr system.
Retrieve employee unpaid pay stubs by idRetrieves the unpaid pay stubs for a specific employee within a company's bamboohr account.
Retrieve time tracking record by idRetrieves a specific time tracking record from bamboohr based on the provided company domain and record id.
Fetch application by idRetrieves detailed information about a specific job application from bamboohr's applicant tracking system.
Fetch applications by company domain pathRetrieves a list of applications submitted through the bamboohr applicant tracking system (ats).
Retrieve employee timesheet dataRetrieves a specific timesheet for a given employee within a bamboohr company environment.
Get benefit coverages by company domainRetrieves the benefit coverages information for employees within a specific company in bamboohr.
Get payroll deductions by idRetrieves detailed information about a specific payroll deduction by its id for a given company in bamboohr.
Retrieve all benefits deduction typesRetrieves a comprehensive list of all deduction types configured in the bamboohr system for a specific company.
List benefit group employeesRetrieves a list of employees associated with benefit groups within a specific bamboohr company instance.
Retrieve benefit group plan costsRetrieves the costs associated with benefit group plans for a specific company in bamboohr.
Retrieve benefit group plansRetrieves a list of benefit group plans for a specified company in bamboohr.
Fetch benefit groupsRetrieves a list of benefit groups for a specific company in bamboohr.
Retrieve benefit plan coverage dataRetrieves detailed information about benefit plan coverages for employees within a specific bamboohr company environment.
Retrieve employee plan by idRetrieves detailed information about a specific employee plan within a company's bamboohr system.
Retrieve benefit plans by company domainRetrieves a list of benefit plans available for the specified company in bamboohr.
Retrieve applicant location dataRetrieves a list of locations associated with the applicant tracking system for a specific bamboohr company account.
Fetch report by company domain and idRetrieves a specific report from the bamboohr system for a given company.
Retrieve meta listsRetrieves metadata about reference lists available in a company's bamboohr instance.
Get employee by idRetrieves detailed information for a specific employee within a company's bamboohr system.
Retrieve employee deduction detailsRetrieves detailed information about a specific employee deduction within a bamboohr company account.
Retrieve employee dependent by idRetrieves detailed information about a specific employee's dependent in bamboohr.
Fetch employee directoryRetrieves the employee directory for a specified bamboohr company.
Get employee project assignmentsRetrieves a list of projects assigned to a specific employee within a company's bamboohr account.
Get Employee Table RowsRetrieves specific table data for a given employee from a company's bamboohr instance.
Retrieve employee goal commentsRetrieves comments associated with a specific goal for a particular employee within a company's bamboohr environment.
Retrieve goals for employee performanceRetrieves the performance goals for a specific employee within a company's bamboohr account.
List employee goals filtersRetrieves the available filters for an employee's performance goals in bamboohr.
Retrieve employee goal filtersRetrieves the available filters for an employee's performance goals in bamboohr.
Fetch hiring leads for applicant trackingRetrieves a list of hiring leads from the bamboohr applicant tracking system (ats) for a specified company.
Fetch applicant tracking jobsRetrieves a list of job postings from the company's applicant tracking system (ats) in bamboohr.
Monitor webhook fieldsRetrieves a list of fields currently being monitored for webhook notifications in bamboohr.
Retrieve employee project assignmentsRetrieves a list of time tracking projects assigned to a specific employee within a bamboohr company environment.
Get changed employees by company domainRetrieves a list of employees whose records have been changed in the bamboohr system for a specific company.
Fetch employees changed for tableRetrieves information about changes made to a specific table in the bamboohr system for a given company.
Get webhooks for company domainRetrieves a list of all webhooks configured for a specific company in bamboohr.
Fetch applicant tracking statusesRetrieves a list of all applicant tracking statuses for a specific bamboohr company.
Get employee project tasksRetrieves a list of tasks assigned to a specific employee for a particular project within a company's bamboohr account.
Fetch time off policiesRetrieves metadata about time off policies for a specific company in the bamboohr system.
Get time off requestsRetrieves a list of time off requests for a specific company in the bamboohr system.
Retrieve time off typesRetrieves a list of available time off types for a specific company in bamboohr.
Retrieve timesheet entriesRetrieves timesheet entries for a specific company in bamboohr.
Retrieve timesheets using company domainRetrieves specific timesheet data from the bamboohr time tracking system.
Get webhook by idRetrieves detailed information about a specific webhook registered in the bamboohr system.
Retrieve webhook log by idRetrieves the log entries for a specific webhook in a company's bamboohr instance.
Check employee clockin statusRetrieves the current clock-in status for a specific employee within a company's bamboohr environment.
View company domain filesThe viewfile endpoint allows you to retrieve and view employee files stored in the bamboohr system.
View employee files by idThis endpoint allows you to view a specific file associated with an employee in the bamboohr system.
Retrieve employee training recordRetrieves the training record for a specific employee within a bamboohr company account.
Retrieve employee time off policiesRetrieves the time off policies applicable to a specific employee within a bamboohr company.
Get employee time off policiesRetrieves the time-off policies applicable to a specific employee within a bamboohr company account.
Access training categoryRetrieves all training categories for a specific company in bamboohr.
Fetch training types by domainRetrieves a list of training types configured in the company's bamboohr system.
Update employee table row infoThis endpoint updates a specific row in an employee's table within bamboohr.
Reopen employee goalReopens a previously closed or completed goal for a specific employee in the bamboohr performance management system.
Generate custom report for companyCreates a custom report in bamboohr with specified parameters.
Upload employee photo by idUpdates the photo for a specific employee in the bamboohr system.
Post clock entries for time trackingThe create clock entries endpoint allows you to add or update time tracking entries for employees in the bamboohr system.
Post daily time tracking entriesThe addorupdatedailytimeentries endpoint allows you to create new or update existing daily time entries for employees in the bamboohr time tracking system.
Update company benefit detailsUpdates an existing company benefit in the bamboohr system.
Update employee dependent detailsThe updateemployeedependent endpoint allows you to modify the information of an existing employee dependent in the bamboohr system.
Update company file detailsUpdates an existing company file in bamboohr, allowing modifications to the file's metadata such as name, category, and employee sharing permissions.
Update employee information via idUpdates an employee's basic information in the bamboohr system.
Update employee specific fileUpdates an existing file associated with a specific employee in the bamboohr system.
Update employee training recordThe updateemployeetrainingrecord endpoint allows you to update an existing training record for a specific employee in the bamboohr system.
Update employee goalUpdates an existing employee goal in the bamboohr system.
Update employee goal commentUpdates a specific comment on an employee's goal in bamboohr's performance management system.
Update employee goal progressUpdates the progress of a specific employee's goal in bamboohr.
Share employee goal with othersUpdates the list of employees with whom a specific performance goal is shared in bamboohr.
Update employee goal with milestonesThis endpoint updates an existing employee goal with milestones in the bamboohr performance management system.
Update employee table row by idUpdates a specific row in a table associated with an employee's record in bamboohr.
Update training categoryThis endpoint allows you to update the name of an existing training category in bamboohr.
Update training type by idUpdates an existing training type in the bamboohr system.
Update webhook for company domainUpdates an existing webhook configuration in bamboohr.
Upload file to company domainThis endpoint allows you to upload files to the bamboohr system for a specific company.
Upload employee fileThis endpoint allows you to upload a file to an employee's record in bamboohr.
Post company loginAuthenticates a user with the bamboohr system, initiating a session for subsequent api calls.
Why Use Composio?
1
AI Native Bamboohr Integration
- Supports both Bamboohr MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Bamboohr data
2
Managed Auth
- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Bamboohr access
- Per user and per environment credentials instead of hard-coded keys
3
Agent Optimized Design
- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf
4
Enterprise Grade Security
- Fine-grained RBAC so you control which agents and users can access Bamboohr
- Scoped, least privilege access to Bamboohr resources
- Full audit trail of agent actions to support review and compliance
Connect Bamboohr MCP Tool with your Agent
Python
TypeScript
1
Install Composio
python
pip install composio claude-agent-sdkInstall the Composio SDK and Claude Agent SDK
2
Create Tool Router Session
python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions
composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.urlInitialize the Composio client and create a Tool Router session
3
Connect to AI Agent
python
import asyncio
options = ClaudeAgentOptions(
permission_mode='bypassPermissions',
mcp_servers={
'tool_router': {
'type': 'http',
'url': url,
'headers': {
'x-api-key': 'your-composio-api-key'
}
}
},
system_prompt='You are a helpful assistant with access to Bamboohr tools.',
max_turns=10
)
async def main():
async with ClaudeSDKClient(options=options) as client:
await client.query('Add time tracking record for employee John Doe for 8 hours on June 10th')
async for message in client.receive_response():
if hasattr(message, 'content'):
for block in message.content:
if hasattr(block, 'text'):
print(block.text)
asyncio.run(main())Use the MCP server with your AI agent
Connect Bamboohr API Tool with your Agent
Python
TypeScript
1
Install Composio
python
pip install composio_openaiInstall the Composio SDK
2
Initialize Composio and Create Tool Router Session
python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider
composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')Import and initialize Composio client, then create a Tool Router session
3
Execute Bamboohr Tools via Tool Router with Your Agent
python
tools = session.tools
response = openai.responses.create(
model='gpt-4.1',
tools=tools,
input=[{
'role': 'user',
'content': 'Add a dependent to employee 123 for health benefits'
}]
)
result = composio.provider.handle_tool_calls(
response=response,
user_id='your-user-id'
)
print(result)Get tools from Tool Router session and execute Bamboohr actions with your Agent
Use Bamboohr with any AI Agent Framework
Choose a Framework you want to connect Bamboohr with
OpenAI Agents SDK
Use Bamboohr MCP with OpenAI Agents SDK
Claude Agents SDK
Use Bamboohr MCP with Claude Agents SDK
Google ADK
Use Bamboohr MCP with Google ADK
Langchain
Use Bamboohr MCP with Langchain
AI SDK
Use Bamboohr MCP with AI SDK
Mastra AI
Use Bamboohr MCP with Mastra AI
LlamaIndex
Use Bamboohr MCP with LlamaIndex
CrewAI
Use Bamboohr MCP with CrewAI
Pydantic AI
Use Bamboohr MCP with Pydantic AI
Autogen
Use Bamboohr MCP with Autogen
Explore Other Toolkits
Recruitee
API KeyOAuth2
Recruitee is collaborative hiring software that centralizes recruitment tasks for teams. It streamlines sourcing, interviewing, and hiring so you can fill roles faster.
Workable
API Key
Workable is an all-in-one HR software platform that streamlines hiring, employee management, and payroll. It helps teams simplify recruiting, onboarding, and staff operations in one place.
Frequently Asked Questions
Do I need my own developer credentials to use Bamboohr with Composio?
Yes, Bamboohr requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.
Can I use multiple toolkits together?
Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.
Is Composio secure?
Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.
What if the API changes?
Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.
Used by agents from
Never worry about agent reliability
We handle tool reliability, observability, and security so you never have to second-guess an agent action.
