Updated March 2026

Install BambooHR

Pick your client, copy the command, done.

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "BAMBOOHR_API_KEY=${BAMBOOHR_API_KEY}" -e "BAMBOOHR_SUBDOMAIN=${BAMBOOHR_SUBDOMAIN}" bamboohr -- npx -y bamboohr-mcp
Required:BAMBOOHR_API_KEYBAMBOOHR_SUBDOMAIN

Environment Variables

Set these before running BambooHR.

VariableDescriptionRequired
BAMBOOHR_API_KEYYour BambooHR API key generated from the profile settingsYes
BAMBOOHR_SUBDOMAINThe subdomain prefix from your BambooHR URLYes

Available Tools (25)

Once configured, BambooHR gives your AI agent access to:

bamboohr_get_employeeGet an employee record by ID
employeeId
bamboohr_list_employeesList all employees in the directory
bamboohr_create_employeeCreate a new employee
employeeData
bamboohr_update_employeeUpdate employee fields
employeeIdupdateData
bamboohr_get_updated_employee_idsGet IDs of recently changed employees
sinceDate
bamboohr_get_company_infoGet company account details
bamboohr_get_time_off_typesList all leave types
bamboohr_get_time_off_policiesList all time-off policies
bamboohr_get_time_off_requestsGet requests by date range, status, employee
startDateendDatestatusemployeeId
bamboohr_create_time_off_requestSubmit a time-off request
employeeIdrequestData
bamboohr_update_time_off_request_statusApprove, deny, or cancel a request
requestIdstatusnote
bamboohr_get_time_off_balanceGet leave balances for an employee
employeeId
bamboohr_get_whos_outSee who is out during a date range
startDateendDate
bamboohr_assign_time_off_policiesAssign policies to an employee
employeeIdpolicyIds
bamboohr_get_timesheet_entriesGet clock/hour entries
startDateendDate
bamboohr_clock_inRecord clock in event
bamboohr_clock_outRecord clock out event
bamboohr_create_hour_entriesSubmit hour entries
entries
bamboohr_list_break_policiesList break policies
bamboohr_list_employee_break_availabilityCheck break availability
employeeId
bamboohr_list_job_summariesList all job openings
bamboohr_create_job_openingCreate a new job opening
jobData
bamboohr_create_candidateCreate a candidate record
candidateData
bamboohr_get_job_applicationsGet applications for a job
jobId
bamboohr_get_applicant_statusesList pipeline statuses

Try It Out

After setup, try these prompts with your AI agent:

Who is out of the office next week?
Onboard Sarah Chen starting Monday in the Engineering department reporting to Maria.
Show me the training compliance status for the Sales team.
Approve all pending PTO requests for my direct reports.
What is our average time-to-fill for engineering roles?
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • BAMBOOHR_API_KEY — Your BambooHR API key generated from the profile settings
  • BAMBOOHR_SUBDOMAIN — The subdomain prefix from your BambooHR URL
Alternative installation methods

Claude Code (CLI)

claude mcp add bamboohr -e BAMBOOHR_API_KEY=your-api-key-here -e BAMBOOHR_SUBDOMAIN=your-company-subdomain -- npx -y bamboohr-mcp

Keep this setup from going cold

Save the docs, env vars, and workflow around BambooHR in Conare so Claude Code, Codex, and Cursor remember it next time.

Need the legacy visual installer? Open Conare IDE.
Remember this setup