Updated March 2026
Install BambooHR
Pick your client, copy the command, done.
1
Add it to Claude Code
Run this in a terminal.
claude mcp add -e "BAMBOOHR_API_KEY=${BAMBOOHR_API_KEY}" -e "BAMBOOHR_SUBDOMAIN=${BAMBOOHR_SUBDOMAIN}" bamboohr -- npx -y bamboohr-mcpRequired:
BAMBOOHR_API_KEYBAMBOOHR_SUBDOMAINEnvironment Variables
Set these before running BambooHR.
VariableDescriptionRequired
BAMBOOHR_API_KEYYour BambooHR API key generated from the profile settingsYesBAMBOOHR_SUBDOMAINThe subdomain prefix from your BambooHR URLYesAvailable Tools (25)
Once configured, BambooHR gives your AI agent access to:
bamboohr_get_employeeGet an employee record by IDemployeeIdbamboohr_list_employeesList all employees in the directorybamboohr_create_employeeCreate a new employeeemployeeDatabamboohr_update_employeeUpdate employee fieldsemployeeIdupdateDatabamboohr_get_updated_employee_idsGet IDs of recently changed employeessinceDatebamboohr_get_company_infoGet company account detailsbamboohr_get_time_off_typesList all leave typesbamboohr_get_time_off_policiesList all time-off policiesbamboohr_get_time_off_requestsGet requests by date range, status, employeestartDateendDatestatusemployeeIdbamboohr_create_time_off_requestSubmit a time-off requestemployeeIdrequestDatabamboohr_update_time_off_request_statusApprove, deny, or cancel a requestrequestIdstatusnotebamboohr_get_time_off_balanceGet leave balances for an employeeemployeeIdbamboohr_get_whos_outSee who is out during a date rangestartDateendDatebamboohr_assign_time_off_policiesAssign policies to an employeeemployeeIdpolicyIdsbamboohr_get_timesheet_entriesGet clock/hour entriesstartDateendDatebamboohr_clock_inRecord clock in eventbamboohr_clock_outRecord clock out eventbamboohr_create_hour_entriesSubmit hour entriesentriesbamboohr_list_break_policiesList break policiesbamboohr_list_employee_break_availabilityCheck break availabilityemployeeIdbamboohr_list_job_summariesList all job openingsbamboohr_create_job_openingCreate a new job openingjobDatabamboohr_create_candidateCreate a candidate recordcandidateDatabamboohr_get_job_applicationsGet applications for a jobjobIdbamboohr_get_applicant_statusesList pipeline statusesTry 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 settingsBAMBOOHR_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-mcpKeep 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.