BambooHR MCP Server

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
README.md

Connect Claude to BambooHR to manage employee records, time off, and hiring.

Give Claude full access to your BambooHR — employees, time off, hiring, benefits, training, and more.

A Model Context Protocol server that connects Claude to BambooHR. Install once, then talk to your HR data in plain English — no dashboards, no manual exports.

"Who's out next week?"
"Onboard Sarah Chen starting Monday — Engineering, reports to Maria."
"Show training compliance for the Sales team."
"Approve all pending PTO requests for my team."
"What's our average time-to-fill for engineering roles?"

What's included

🔧 74 MCP Tools Full BambooHR API coverage across 11 modules — employees, time off, time tracking, ATS, benefits, training, goals, reports, webhooks, files, and metadata.

📦 Zero-deploy setup Ships as an npx-runnable package. Add two lines to your Claude config and you're done.

🎭 30 Role-Based Skills Pre-built workflows for HR admins, managers, recruiters, employees, payroll, L&D, and automation admins — organized by who uses them.

🔌 Works everywhere Claude Desktop, Claude Code CLI, or any MCP-compatible client.

Quickstart

Step 1 — Get your BambooHR API key

  1. Log in to BambooHR
  2. Click your profile icon (top right) > API Keys
  3. Click Add New Key, name it, and copy it

Your subdomain is the prefix in your BambooHR URL — e.g. acme from acme.bamboohr.com.

Step 2 — Add to Claude Desktop

Edit your config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "bamboohr": {
      "command": "npx",
      "args": ["-y", "bamboohr-mcp"],
      "env": {
        "BAMBOOHR_API_KEY": "your-api-key-here",
        "BAMBOOHR_SUBDOMAIN": "your-company-subdomain"
      }
    }
  }
}

Restart Claude Desktop.

Step 3 — Or add to 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

Step 4 — Verify

Open Claude and ask: "Show me the BambooHR employee directory"

Available Tools

👤 Employees — 6 tools
Tool Description
bamboohr_get_employee Get an employee record by ID
bamboohr_list_employees List all employees in the directory
bamboohr_create_employee Create a new employee
bamboohr_update_employee Update employee fields
bamboohr_get_updated_employee_ids Get IDs of recently changed employees
bamboohr_get_company_info Get company account details
🏖️ Time Off — 8 tools
Tool Description
bamboohr_get_time_off_types List all leave types
bamboohr_get_time_off_policies List all time-off policies
bamboohr_get_time_off_requests Get requests by date range, status, employee
bamboohr_create_time_off_request Submit a time-off request
bamboohr_update_time_off_request_status Approve, deny, or cancel a request
bamboohr_get_time_off_balance Get leave balances for an employee
bamboohr_get_whos_out See who is out during a date range
bamboohr_assign_time_off_policies Assign policies to an employee
⏱️ Time Tracking — 5 tools
Tool Description
bamboohr_get_timesheet_entries Get clock/hour entries
bamboohr_clock_in / bamboohr_clock_out Record clock events
bamboohr_create_hour_entries Submit hour entries
bamboohr_list_break_policies List break policies
bamboohr_list_employee_break_availability Check break availability
🎯 Applicant Tracking (ATS) — 9 tools
Tool Description
bamboohr_list_job_summaries List all job openings
bamboohr_create_job_opening Create a new job opening
bamboohr_create_candidate Create a candidate record
bamboohr_get_job_applications Get applications for a job
bamboohr_get_applicant_statuses List pipeline

Tools (25)

bamboohr_get_employeeGet an employee record by ID
bamboohr_list_employeesList all employees in the directory
bamboohr_create_employeeCreate a new employee
bamboohr_update_employeeUpdate employee fields
bamboohr_get_updated_employee_idsGet IDs of recently changed employees
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
bamboohr_create_time_off_requestSubmit a time-off request
bamboohr_update_time_off_request_statusApprove, deny, or cancel a request
bamboohr_get_time_off_balanceGet leave balances for an employee
bamboohr_get_whos_outSee who is out during a date range
bamboohr_assign_time_off_policiesAssign policies to an employee
bamboohr_get_timesheet_entriesGet clock/hour entries
bamboohr_clock_inRecord clock in event
bamboohr_clock_outRecord clock out event
bamboohr_create_hour_entriesSubmit hour entries
bamboohr_list_break_policiesList break policies
bamboohr_list_employee_break_availabilityCheck break availability
bamboohr_list_job_summariesList all job openings
bamboohr_create_job_openingCreate a new job opening
bamboohr_create_candidateCreate a candidate record
bamboohr_get_job_applicationsGet applications for a job
bamboohr_get_applicant_statusesList pipeline statuses

Environment Variables

BAMBOOHR_API_KEYrequiredYour BambooHR API key generated from the profile settings
BAMBOOHR_SUBDOMAINrequiredThe subdomain prefix from your BambooHR URL

Configuration

claude_desktop_config.json
{"mcpServers": {"bamboohr": {"command": "npx", "args": ["-y", "bamboohr-mcp"], "env": {"BAMBOOHR_API_KEY": "your-api-key-here", "BAMBOOHR_SUBDOMAIN": "your-company-subdomain"}}}}

Try it

→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?

Frequently Asked Questions

What are the key features of BambooHR?

Full BambooHR API coverage across 11 modules including employees, time off, and ATS.. Supports 74 distinct tools for comprehensive HR operations management.. Includes 30 pre-built role-based workflows for admins, recruiters, and employees.. Zero-deploy setup via npx for immediate integration with Claude Desktop or CLI.. Enables natural language querying of HR data without manual dashboards or exports..

What can I use BambooHR for?

HR Admins automating the onboarding process for new hires.. Managers quickly approving or denying team PTO requests via chat.. Recruiters checking the status of job openings and candidate pipelines.. Employees checking their own leave balances or clocking in/out.. Operations teams generating reports on training compliance or hiring metrics..

How do I install BambooHR?

Install BambooHR by running: Add to claude_desktop_config.json

What MCP clients work with BambooHR?

BambooHR works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep BambooHR docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all other servers →

Related MCP Servers

Nuclear
Free, open-source music player without ads or tracking.
other17.1K stars
Domain Check
Fast domain availability checker with RDAP/WHOIS lookup and batch checking.
other253 stars
US Government Open Data MCP
MCP Server + TypeScript SDK for 40+ U.S. Government APIs
other90 stars
Garmin Connect
Access your fitness, health, and training data from MCP clients.
other71 stars
BinjaLattice MCP
Secure communication protocol for Binary Ninja and MCP servers
other61 stars
Ghidra Headless MCP
Headless Ghidra server for AI-driven reverse engineering and analysis
other46 stars