BambooHR
HRIS for small businesses.
Verdict
Common use cases
- Pull headcount reports during budget planning
- Approve timesheets for remote team members
- Adjust PTO balances after policy changes
- Add quarterly goals during performance reviews
- Track time entries for project billing
Integration
- Vendor
- BambooHR
- Category
- productivity
- Auth
- API_KEY
- Tools
- 50
- Composio slug
bamboohr
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 asso
- Add comment to employee goal
This endpoint allows you to post a comment on a specific employee's goal within the bamboohr performance management system. it's used to provide feedback, updates, or additional information related to an employee's progress on a particular
- Add employee goal
This endpoint allows you to add a new goal for a specific employee in the bamboohr performance management system. it's used to create structured, trackable objectives that can be aligned with company strategies and shared among team members
- 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 bambooh
- 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 organiza
- Add webhook with monitoring fields
The addwebhook endpoint allows you to create a new webhook in bamboohr, enabling real-time notifications for specific employee data changes. this tool is used to set up automated data synchronization between bamboohr and external systems, t
- Adjust employee time off balance
This endpoint allows you to adjust the time off balance for a specific employee in bamboohr. it's used to make corrections, add or subtract time off, or reconcile discrepancies in an employee's time off records. the adjustment is applied to
- Approve timesheets for employees that are currently clocked in
This endpoint will approve all timesheets for employees that are currently clocked in. it will only approve the current timesheet, not any previous timesheets.
- Approve timesheets with timestamp
The approvetimesheets endpoint enables managers or authorized personnel to approve multiple employee timesheets in a single api call within the bamboohr time tracking system. this function streamlines the timesheet approval process, which i
- Check employee goal creation permission
This endpoint checks whether a specific employee has the permission to create goals within the bamboohr performance management system. it is useful for determining user capabilities before attempting to create or modify goals, ensuring prop
- Clock in employee with time and location
This endpoint records a clock-in event for a specific employee in the bamboohr time tracking system. it allows for precise tracking of work hours, including the start time, associated project and task, and optionally, the location of the cl
- Clock out employee with location
The clockoutemployee endpoint allows you to record an employee's clock-out time and location in the bamboohr time tracking system. this endpoint should be used when an employee finishes their work session and needs to log their end time and
- Close employee goal
The closeemployeegoal endpoint allows you to mark a specific performance goal as completed or closed for an individual employee in bamboohr. this action is typically used when an employee has achieved their goal or when the goal period has
- 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 det
- 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 primaril
- 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 p
- 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 ch
- 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 payr
- 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
- 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
- Create time tracking project
Creates a new time tracking project in bamboohr. this endpoint allows you to set up a project with customizable settings such as billability, employee access, and associated tasks. use this when you need to establish a new project for track
- Delete clock entry idsdestructive
Deletes multiple clock entries from the bamboohr time tracking system. this endpoint allows administrators to remove specific time tracking records, which is useful for correcting errors, managing outdated entries, or cleaning up the time t
- Delete company benefit by iddestructive
Deletes a specific company benefit from the bamboohr system. this endpoint should be used when you need to remove a benefit that is no longer offered or relevant to the company. it permanently removes the benefit from the system, so it shou
- Delete employee direct deposit accountsdestructive
Deletes a specific direct deposit account associated with an employee in the bamboohr system. this endpoint should be used when an employee's direct deposit account needs to be removed, such as when an employee closes a bank account or requ
- Delete employee file by iddestructive
Deletes a specific file associated with an employee in the bamboohr system. this endpoint should be used when you need to permanently remove a document or file from an employee's record. it's particularly useful for maintaining data accurac
- Delete employee pay stub by iddestructive
Deletes a specific employee pay stub from the bamboohr system. this endpoint should be used when there's a need to remove an incorrect or outdated pay stub from an employee's record. it permanently removes the pay stub data, so it should be
- Delete employee training recorddestructive
Deletes a specific employee training record from the bamboohr system. this endpoint is used to permanently remove a training record associated with an employee, such as completed courses, certifications, or professional development activiti
- Delete employee unpaid pay stubdestructive
This endpoint deletes a specific unpaid pay stub for an employee in the bamboohr system. it is used to remove outdated, erroneous, or unnecessary unpaid pay stub records from the company's hr database. the operation is irreversible, so it s
- Delete employee withholding by iddestructive
Deletes a specific employee withholding record from the bamboohr system. this endpoint is used to remove tax deduction or other financial withholding information for an employee. it should be used when you need to permanently remove outdate
- Delete file by iddestructive
Deletes a specific file from the bamboohr system for a given company. this endpoint is used when you need to permanently remove a file from an employee's records or the company's document storage in bamboohr. it should be used with caution
- Delete time tracking entrydestructive
The deletetimetrackingentry endpoint allows for the deletion of a specific time tracking entry from the bamboohr system. this operation is used when you need to remove an individual time tracking record, such as an incorrectly entered time-
- Employee clock in via taskid
Clocks in an employee in the bamboohr time tracking system, marking the start of their work period. this endpoint should be used when an employee begins their work shift or returns from a break. it allows for optional association with speci
- Fetch goal alignment options
Retrieves the available goal alignment options for a specific employee or the authenticated api user in bamboohr. this endpoint is used to fetch possible alignment choices for employee goals, which helps in ensuring that individual objectiv
- 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 t
- 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
- Post application status update
Updates the status of a specific application in the bamboohr applicant tracking system. this endpoint allows you to change the current status of an application, which is useful for tracking the progress of candidates through your hiring pro
- Post employee clock out
This endpoint clocks out an employee in the bamboohr time tracking system, marking the end of their working hours. it should be used when an employee finishes their work shift or needs to record the end of their working time. the endpoint i
- Post employee clock out datetime
This endpoint records the clock-out time for a specific employee in the bamboohr time tracking system. it should be used when an employee ends their work shift or workday. the endpoint requires the company domain, employee id, and the exact
- 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 allocatio
- 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 e
- Post training category via domain
Creates a new training category in the bamboohr system. this endpoint allows hr administrators to organize and structure their training programs by adding custom categories. use this when you need to introduce a new classification for train
- Post training object for a company domain
Creates a new training type in the bamboohr system with specified attributes and settings. this endpoint allows hr administrators to define and customize various aspects of a training program, including its name, description, renewal requir
- 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 date
- Retrieve employee performance options
Retrieves the list of employees with whom a specific employee's goals can be shared within bamboohr. this endpoint is used to determine the visibility options for an employee's performance goals, allowing hr managers or system administrator
- 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 t
- 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 proj
- 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 endpoi
- 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 pa
- 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
- Update time off request status
This endpoint updates the status of a specific time-off request in bamboohr. it allows hr managers or authorized personnel to approve, deny, or cancel an employee's time-off request. the endpoint is used when a decision has been made regard
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the MCP Integrations section. 2. Click 'Add Integration' and select BambooHR from the list. 3. Log into your BambooHR account and generate an API key from Settings > API Keys (you'll need admin access). 4. Copy the key and paste it into Switchy's connection form, then click 'Connect'. 5. Switchy will verify the key and display which BambooHR fields your key can access — confirm the scopes match what your team needs (employee directory, time tracking, goals, benefits). 6. Open any Space and type '@BambooHR list employees' to test the connection; you should see a list of active employees. 7. To invoke a tool, @mention BambooHR in a message and describe the task in plain language — for example, '@BambooHR add 8 hours of PTO to Jane Doe's balance' or '@BambooHR show me all employees in the Engineering department'. 8. Review the response to confirm the action completed, especially for write operations like timesheet approvals or goal updates.
What teammates see: by default, memories from BambooHR are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Department Headcount
@BambooHR list all active employees in the Engineering department, including their job titles and start dates.Open in a Space →
Approve Pending Timesheets
@BambooHR approve all timesheets for employees who are currently clocked in.Open in a Space →
Add PTO Adjustment
@BambooHR add 16 hours to Sarah Johnson's PTO balance with the note 'Carryover from 2024'.Open in a Space →
Create Employee Goal
@BambooHR add a goal for Michael Chen titled 'Ship v2 API by Q2' with a due date of June 30, 2025.Open in a Space →
Log Time Entry
@BambooHR add a time tracking record for Alex Martinez: 8 regular hours and 2 overtime hours on May 15, 2025.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@BambooHR show me all employees who have used more than 80% of their PTO balance this year, grouped by department
Based on current BambooHR data, 12 employees have used over 80% of their PTO balance year-to-date. Engineering has 5 employees in this range (Sarah Chen at 92%, Marcus Liu at 87%, three others between 81-84%). Sales has 4 employees (highest: Jordan Wells at 95%). Marketing has 2, Operations has 1. Note that these figures reflect approved time off only; pending requests are not included in the calculation.
This example demonstrates read-heavy synthesis across employee records and time-off data. Requires OAuth scope for viewing employee PTO balances and department assignments. The MCP fetches raw balance data; the AI performs the filtering and grouping logic. Useful for workforce planning but won't flag employees with pending requests that would push them over the threshold.
@BambooHR add a new goal for employee ID 8472: 'Complete AWS Solutions Architect certification by Q3 2025' with category 'Professional Development'
Goal created successfully for employee ID 8472. Title: 'Complete AWS Solutions Architect certification by Q3 2025'. Category: Professional Development. Status: Not Started. Due Date: September 30, 2025. The goal is now visible in the employee's performance dashboard and can be tracked through quarterly check-ins. You or the employee's manager can add progress comments or milestones using the goal ID returned (goal-19384).
This write action creates a trackable objective in BambooHR's performance system. Requires OAuth scope for managing employee goals. The MCP confirms creation but doesn't validate whether the employee exists or has access to view the goal—check permissions separately. Side effect: the employee and their manager receive a notification about the new goal assignment.
@BambooHR pull the last 30 days of time tracking records for the Engineering team and draft a summary of overtime trends
Over the past 30 days, the Engineering team logged 1,847 total hours across 14 employees. Overtime accounted for 203 hours (11% of total), concentrated in the final two weeks of the period. Three engineers logged significant overtime: Alex Rivera (38 OT hours), Jamie Patel (29 OT hours), and Casey Moore (24 OT hours). The spike correlates with the product launch sprint documented in project management tools. Recommendation: monitor these three employees for burnout risk and consider redistributing workload if the pattern continues into next month.
This synthesis example pairs BambooHR's time tracking data with AI reasoning to surface workforce health signals. Requires OAuth scope for reading time records and employee department data. The MCP provides raw hours; the AI calculates percentages and identifies patterns. Rate limit consideration: fetching records for large teams may require pagination. Use this for retrospective analysis, not real-time monitoring.
Use-case deep-dives
When BambooHR wins for distributed team onboarding workflows
A 12-person startup hiring across three time zones needs to spin up benefits, goals, and time tracking for each new hire without manual data entry. BambooHR's MCP handles this well: the 'Add benefit group employee record' and 'Add employee goal' tools let you script the entire enrollment sequence from Switchy, triggered by a Slack message or calendar event. OAuth2 auth means your People Ops lead grants access once, and the team can run onboarding playbooks without touching the BambooHR UI. The threshold: if you're hiring fewer than two people per month, the setup overhead outweighs the time saved. But at three-plus hires monthly, this MCP turns a 45-minute checklist into a two-minute Switchy workflow.
BambooHR for real-time timesheet approval in distributed ops
A 20-person field services team clocks in from job sites, and the ops manager needs to approve timesheets before payroll runs Friday afternoon. The 'Approve timesheets for employees that are currently clocked in' tool lets you bulk-approve from Switchy without opening BambooHR's web portal. Pair it with the 'Add time tracking record' tool to log corrections on the fly when a crew lead reports a missed punch. This works if your team uses BambooHR's native time clock; if you're syncing from an external system, the webhook tool ('Add webhook with monitoring fields') is the better play to catch changes as they happen. At under 15 field employees, manual approval is faster. Above that, this MCP saves 20 minutes every payroll cycle.
When BambooHR's goal tools streamline quarterly review cycles
A 30-person SaaS company runs quarterly performance reviews, and each manager needs to pull goal progress, add comments, and adjust time-off balances for their direct reports. The 'Add comment to employee goal' and 'Adjust employee time off balance' tools let managers work from a single Switchy thread instead of tabbing between BambooHR, Slack, and their notes doc. The 50-tool catalog means you can script the full review workflow—pull goals, post feedback, reconcile PTO—without leaving the AI workspace. The catch: if your review process is ad-hoc or managers prefer the BambooHR UI, the MCP adds friction. But for teams running structured review cycles with 10-plus managers, this cuts review prep time by a third.
Frequently asked
What can the BambooHR MCP do in Switchy?
The BambooHR MCP lets your AI agents read and write employee data, manage time tracking, adjust PTO balances, post goal comments, enroll staff in benefit groups, and approve timesheets. It covers 50 tools spanning HR records, performance management, and time-off workflows — so agents can answer questions or take action without switching to the BambooHR web app.
Do I need admin access to connect BambooHR via OAuth?
Yes. BambooHR's OAuth flow requires account-level permissions to grant read and write access across employee records, goals, time tracking, and benefits. A standard employee account won't have the scopes needed. Your BambooHR admin should connect the integration in Switchy, or delegate the OAuth consent to someone with full API access.
Can the MCP create new employees or update org charts?
The MCP can update employee fields and manage goals, time tracking, and benefits, but it doesn't expose tools for creating new employee records or restructuring reporting lines. For onboarding or org-chart changes, you'll still use BambooHR's web interface or a dedicated onboarding API if your plan includes it.
Why use this instead of logging into BambooHR directly?
The MCP lets agents pull data and take actions mid-conversation — approve a timesheet, check someone's PTO balance, or log hours — without context-switching. If you're already in Switchy discussing a project, the agent handles the HR task inline. For bulk edits or complex reporting, BambooHR's own UI is still faster.
Who on the team should connect the BambooHR integration?
Your HR admin or someone with full BambooHR API permissions. Once connected, any Switchy user can ask agents to query or update data within the scopes granted. If you want to restrict who can approve timesheets or adjust balances, manage that through BambooHR's role settings before connecting.