Skip to main content
Glama
BambooHR MCP Server

BambooHR MCP Server

by mikkmihkel

BambooHR for Claude

CI Read-only License: MIT

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)

  1. Create an API key. In BambooHR: your photo (bottom left) → API Keys → Add New Key. Copy it; it is shown once.

  2. Download bamboohr-mcp.mcpb.

  3. Double-click it. Claude Desktop asks for:

    • BambooHR subdomain: acme if your BambooHR is at acme.bamboohr.com

    • BambooHR API key: the key from step 1

  4. 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 acme, not acme.bamboohr.com.

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. Vacation) in Configure → Vacation time-off type.

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 tools
bamboohr_changed_employeesChanged employeesA
Read-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 holidaysA
Read-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 reportA
Read-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 employeeA
Read-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 employeesA
Read-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 fieldsA
Read-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 tablesA
Read-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 typesA
Read-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 usersA
Read-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 rowsA
Read-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 balancesA
Read-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 requestsA
Read-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 recordsA
Read-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 typesA
Read-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 overviewA
Read-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 outA
Read-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

    A3.9/5.0

    Scored across 16 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      15
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A read-only MCP server for BambooHR that enables safe AI assistant access to employee records, time-off, files, and directories via natural language queries.
      10
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -