BambooHR MCP Server
This is a read-only MCP server that lets Claude query BambooHR data about employees, time off, training, and company info.
Who's out: List employees on time off and company holidays in a date range.
Employee directory: Search and filter employees by name, email, department, or location; get id, job title, supervisor, etc.
Time-off types: List available time-off types (excluding health-related) and their units.
Time-off balances: Check one employee's vacation/sick balances as of a date, including used YTD.
Time-off requests: List requests by date range, employee, status, or type.
Vacation overview: Per department or employee list: balances, planned/unplanned vacation, longest continuous block, and whether 14-day blocks exist.
Employee fields: Discover standard and custom fields (e.g., shoe size) and whether they are readable.
Employee tables: List tabular data (job history, employment status, custom tables like equipment/certificates).
Company holidays: List holidays for a date range.
BambooHR users: List user accounts with status and last login for access reviews.
Get employee: Read a single employee's standard and custom field values (allow-listed only).
Employee report: Pull fields for a group of employees (by department, location, etc.) with filters.
Table rows: Read rows from a specific employee table for one employee.
Changed employees: See which employees were inserted, updated, or deleted since a timestamp.
Training types: List training categories, renewal periods, etc.
Training records: List one employee's completed trainings with details.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BambooHR MCP Server Who is out of office this week?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BambooHR for Claude
Eesti keeles: README.et.md
Ask Claude about your BambooHR data: who is out, vacation balances, employee fields, training and holidays. Read-only: it never creates, approves or changes anything in BambooHR.
Install (Claude Desktop, 5 minutes)
Create an API key. In BambooHR: your photo (bottom left) → API Keys → Add New Key. Copy it; it is shown once.
Download
bamboohr-mcp.mcpb.Double-click it. Claude Desktop asks for:
BambooHR subdomain:
acmeif your BambooHR is atacme.bamboohr.comBambooHR API key: the key from step 1
Click Install, start a new chat and ask: Who is out this week?
No Node.js, no terminal. The key is kept in your operating system's credential store, never in a file. Double-click does nothing? Settings → Extensions → Advanced settings → Install Extension and pick the file. To change the key or subdomain later: Settings → Extensions → BambooHR → Configure.
Related MCP server: bamboohr-mcp
Try asking
Who is out next week?
How many vacation days does Anna Tamm have left?
Who in Engineering has not taken a 14-day vacation this year?
Which time-off requests in October are still waiting for approval?
When did Mart Mets start, and who is their manager?
Shoe sizes of everyone in the Tallinn office. (custom fields work too)
Has Anna done first-aid training?
Which public holidays are left this year?
Ask per department, office or person. One answer covers at most 25 people; for more, Claude will ask you to narrow it down.
What it will not show
You see at most what your own BambooHR account can see, and less:
Never: salary, bonuses, bank details, national id numbers, date of birth, home address, gender and similar personal fields.
Sick leave shows only as "absent", without reason or notes.
Dependents and employee documents are off unless an administrator turns them on.
If you ask for any of these, Claude says the field is excluded by policy. That is intentional.
Troubleshooting
You see | Fix |
"No BambooHR API key is available" | Settings → Extensions → BambooHR → Configure, fill in the key and subdomain. |
"is not a bare BambooHR subdomain" | Enter only |
Error 401 | Wrong or revoked key. Create a new one and paste it in Configure. |
Error 403, or people missing from answers | Your BambooHR account cannot see that data. Ask your BambooHR admin. |
"above the per-call limit" | Ask about a smaller group: one department, office or person. |
Vacation type not found | Put the exact name (e.g. |
Installed, but no answers | Quit Claude Desktop completely and reopen it. |
Privacy and data flow
Data goes from BambooHR to the extension on your computer, and from there into your Claude chat. No BambooHR data is stored on disk.
A local audit log records which tool ran and which fields were asked for, never values or names. It is never sent anywhere.
The key is only sent to
https://<subdomain>.bamboohr.com. The only other request is a version check at start-up; it sends only the version number.If a key leaks, delete it in BambooHR under API Keys. To remove the extension: Settings → Extensions → BambooHR → Uninstall.
Read-only is enforced by this extension, not by BambooHR. An API key has the same rights as the account that created it. Use an account with the narrowest access you need. Provided as is under the MIT licence, without warranty or liability; you are responsible for your organisation's data-protection obligations.
For administrators and developers
Security design, settings, command line, Claude Code setup, release verification and development: docs/ADMIN.md. Changes: CHANGELOG.md.
License
MIT, see LICENSE.
Available Tools
16 toolsbamboohr_changed_employeesChanged employeesARead-onlyIdempotent
List employees whose record changed since a timestamp: new hires (Inserted), edits to any field or table (Updated), and removals (Deleted). Ids and timestamps only, no field values. Newest first. Use bamboohr_get_employee to see the current values.
Inputs: since (required), type.
bamboohr_company_holidaysCompany holidaysARead-onlyIdempotent
List company holidays that overlap a date range. Default: the current calendar year. Multi-day holidays that overlap the range are included.
Inputs: end, start.
bamboohr_employee_reportEmployee reportARead-onlyIdempotent
Pull chosen fields for a bounded group of employees in one call: e.g. hire date and a custom field such as shoe size for one department. Requires either employeeIds or a department, location or division filter (exact name, case-insensitive); company-wide reports are refused. At most the configured per-call record limit of rows is returned, otherwise the call is refused — narrow the filter. Only allow-listed and custom fields may be requested; pay, bank, birth date and similar fields are refused. id, displayName and status are always included. Inactive (terminated) employees are excluded unless includeInactive is true. missingFields lists fields BambooHR did not return, usually because the API key may not see them or the name is wrong; check names with bamboohr_list_fields.
Inputs: fields (required), division, location, department, +2 more.
bamboohr_get_employeeGet employeeARead-onlyIdempotent
Read one employee's field values: standard fields (hire date, job title, supervisor, status, work contact details) and custom fields (e.g. shoe size). Omit employeeId to read the API key owner's own record. Omit fields for a sensible default set. Fields outside the allow-list — pay, bank, national id, date of birth, gender, home contact details — are refused and nothing is returned; ask for other fields instead. missingFields lists requested fields that came back empty or that the key may not see.
Inputs: fields, employeeId.
bamboohr_list_employeesList employeesARead-onlyIdempotent
Look up employees in the BambooHR directory with id, name, job title, department, division, location, supervisor and work email. Requires search, department or location — listing the whole company in one call is not allowed — and returns at most the per-call record limit of people. Use the id with the balance and request tools.
Inputs: search, location, department.
bamboohr_list_fieldsList employee fieldsARead-onlyIdempotent
List every employee field in this BambooHR account, standard and custom, with id, name, API alias, type and an allowed flag. Only fields with allowed:true can be read by bamboohr_get_employee or bamboohr_employee_report; the rest (pay, bank, national id, date of birth, gender, home contact details) are refused by policy. Use search to find a field by name (e.g. 'shoe', 'hire'). Set includeOptions to see the allowed values of list fields.
Inputs: search, includeOptions.
bamboohr_list_tablesList employee tablesARead-onlyIdempotent
List the tabular fields this server may read (job history, employment status, and custom tables such as equipment or certificates) with the table alias and its columns. Compensation, bonus, bank, identity-document, health and similar tables, and money-type columns, are excluded by policy and are not listed. Use the alias with bamboohr_table_rows.
Inputs: no named parameters.
bamboohr_list_time_off_typesList time-off typesARead-onlyIdempotent
List the company's time-off types (e.g. vacation, unpaid leave) with their ids and units, plus the default hours per weekday. Use this to find the right type name or id for other tools. Health-related types (sick leave, care leave and similar) are excluded by policy and are not listed; health-related absences appear elsewhere as a generic 'absent'.
Inputs: no named parameters.
bamboohr_list_usersList BambooHR usersARead-onlyIdempotent
List BambooHR user accounts (people who can log in) with their linked employee id, status and last login (no email: BambooHR may return a home address there). Useful for access reviews: who has an enabled account, who never logged in. Narrow the list with status or search; more accounts than the per-call record limit are refused.
Inputs: search, status.
bamboohr_table_rowsTable rowsARead-onlyIdempotent
Read the rows of an employee table for ONE employee: job history (jobInfo), employmentStatus, or any custom table (e.g. equipment, certificates). employeeId is required. Pay, compensation, bank, identity-document, health and similar tables are excluded by policy and are refused; money-type columns are dropped. Get valid table aliases from bamboohr_list_tables. Rows are unsorted; sort by date yourself.
Inputs: table (required), employeeId (required).
bamboohr_time_off_balancesTime-off balancesARead-onlyIdempotent
Get one employee's time-off balances as of a date, including amount used year-to-date. Use a future date to project the balance. Health-related balances (sick leave and similar) are not reported.
Inputs: employeeId (required), asOf.
bamboohr_time_off_requestsTime-off requestsARead-onlyIdempotent
List time-off requests overlapping a date range, optionally filtered by employee, status and time-off type. Health-related absences are reduced to type 'absent' with no notes. Results are limited to employees the API key's owner may see, and to the per-call record limit.
Inputs: end (required), start (required), status, employeeId, +1 more.
bamboohr_training_recordsTraining recordsARead-onlyIdempotent
List one employee's completed trainings with completion date, instructor, hours, credits, cost and notes. Optionally limit to one training type. To check who is missing a required training, call this per employee.
Inputs: employeeId (required), trainingTypeId.
bamboohr_training_typesTraining typesARead-onlyIdempotent
List the company's training types (name, category, required, renewable, renewal frequency in months, due window for new hires) and training categories. Use the type id with bamboohr_training_records.
Inputs: no named parameters.
bamboohr_vacation_overviewVacation overviewARead-onlyIdempotent
Vacation report for one department (or a list of employeeIds) and one calendar year: vacation balance as of a date, used year-to-date, vacation planned after that date (approved or requested), unplanned balance (balance minus planned), the longest continuous vacation block in calendar days, and whether they have at least one 14-day continuous block. Adjacent requests are merged into one block. A department or employeeIds is required — a company-wide overview in one call is not allowed, ask per department — and the group must fit the per-call record limit. Use onlyMissingFourteenDayBlock to list only employees without a 14-day vacation. The summary counts all employees before that filter. Note: planned vacation excludes a request already in progress on the as-of date, on the assumption that BambooHR's balance has already deducted it.
Inputs: asOf, year, department, employeeIds, +2 more.
bamboohr_whos_outWho's outARead-onlyIdempotent
List employees who are out of office and company holidays in a date range. Defaults to today through 14 days ahead. Each entry has type 'timeOff' (with employeeId and employee name) or 'holiday' (holiday name only). A range with more people out than the per-call record limit is refused (holidays do not count); use a shorter range.
Inputs: end, start.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Tools mostly map to distinct resources and actions, with detailed descriptions clarifying boundaries. Some overlap exists between whos_out, time_off_requests, and company_holidays, and between list_employees, get_employee, and employee_report, but these are unlikely to cause serious misselection.
All tools share the bamboohr_ prefix and snake_case, but the naming convention is mixed: some use list_ or get_ while many are bare noun phrases like training_types, table_rows, or vacation_overview. This is readable but does not follow a consistent verb_noun pattern.
At 16 tools, the server is slightly above the typical 3-15 range, but the count is justified by the breadth of HR subdomains covered: employees, time off, training, tables, users, holidays, and change tracking. Each tool serves a distinct purpose and none feels redundant.
The server provides strong read-only coverage of common HR workflows: employee lookup, field metadata, time-off balances and requests, training records, holidays, and change tracking. Minor gaps exist, such as training compliance requiring per-employee calls and company-wide reports being intentionally blocked, but agents can work around these.
Maintenance
Related MCP Connectors
Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.
Ask your Quickbase apps in plain language. Read-only by default; writes need human approval.
Ask your databases questions in plain English, run read-only SQL and set up data alerts.
Ask questions in plain language, get answers from your business database. No SQL required.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with BambooHR's API through natural language queries. Provides access to employee data, time off management, company files, and HR operations with comprehensive tools for workforce management.108 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables natural language interaction with BambooHR to manage employee records, time off, hiring, and benefits. It provides 74 tools and pre-built workflows to automate HR operations like onboarding, reporting, and performance tracking.15MIT
- AlicenseAqualityDmaintenanceA read-only MCP server for BambooHR that enables safe AI assistant access to employee records, time-off, files, and directories via natural language queries.10MIT
- FlicenseNot gradedqualityDmaintenanceEnables querying an HR analytics database (hr_db) using natural language, providing tools to get database schema and run read-only SQL queries for HR metrics like headcount, attrition, and payroll.-