BambooHR MCP Server

A Model Context Protocol (MCP) server for interacting with BambooHR's API.

Features

Employee Management

• Get All Employees: Retrieve a list of all employees with customizable fields
• Get Employee Details: Get detailed information about a specific employee
• Create Employee: Add new employees to the system
• Update Employee: Modify existing employee information

Time Off Management

• Get Time Off Requests: List time off requests with filtering options
• Create Time Off Request: Submit new time off requests
• Update Time Off Request: Approve, deny, or cancel time off requests
• Get Time Off Balance: Check employee time off balances

Installation

npm install
npm run build

Configuration

Create a .env file based on .env.example:

BAMBOOHR_COMPANY_DOMAIN=your_company_subdomain
BAMBOOHR_BEARER_TOKEN=your_api_token

Getting Your API Token

1. Log into BambooHR as an administrator
2. Click your profile picture in the upper right corner
3. Choose "API Keys"
4. Click "Add New Key"
5. Give it a name and click "Generate Key"
6. Copy the API key immediately (you won't be able to see it again)

Usage

As an MCP Server

npm start

Development Mode

npm run dev

Available Tools

Employee Tools

bamboohr_get_all_employees

Get all employees with specified fields.

Parameters:

• fields (optional): Array of field names to retrieve

bamboohr_get_employee

Get detailed information about a specific employee.

Parameters:

• employeeId: The unique ID of the employee

bamboohr_create_employee

Create a new employee.

Parameters:

• firstName: Employee's first name
• lastName: Employee's last name
• email (optional): Email address
• department (optional): Department name
• jobTitle (optional): Job title
• hireDate (optional): Hire date (YYYY-MM-DD)
• supervisorId (optional): Supervisor's employee ID
• location (optional): Work location
• workPhone (optional): Work phone number

bamboohr_update_employee

Update an existing employee's information.

Parameters:

• employeeId: The unique ID of the employee
• All other parameters from create (optional)

Time Off Tools

bamboohr_get_time_off_requests

Get time off requests with filtering options.

Parameters:

• employeeId (optional): Filter by employee
• startDate (optional): Start date (YYYY-MM-DD)
• endDate (optional): End date (YYYY-MM-DD)
• status (optional): Filter by status

bamboohr_create_time_off_request

Create a new time off request.

Parameters:

• employeeId: Employee ID
• start: Start date (YYYY-MM-DD)
• end: End date (YYYY-MM-DD)
• timeOffTypeId: Time off type ID
• amount: Amount of time off
• unit: 'days' or 'hours'
• notes (optional): Request notes

bamboohr_update_time_off_request

Update a time off request status.

Parameters:

• requestId: Request ID
• status: 'approved', 'denied', or 'canceled'
• note (optional): Decision note

bamboohr_get_time_off_balance

Get time off balance for an employee.

Parameters:

• employeeId: Employee ID

License

MIT