BambooHR MCP

- TypeScript types for all models and API responses
- Simple, promise-based API for all major BambooHR endpoints
- Easy to extend and integrate into your own projects

npm install

You can pass your BambooHR API token and company domain directly to the methods, or use environment variables:

Required:

- BAMBOOHR_TOKEN — Your BambooHR API token
- BAMBOOHR_COMPANY_DOMAIN — Your BambooHR company domain (the part before .bamboohr.com)
- BAMBOOHR_EMPLOYEE_ID — Your BambooHR employee ID

You can find your employee ID in several ways:

1. From your profile URL: When viewing your profile, the URL will contain your employee ID (e.g., https://yourcompany.bamboohr.com/employees/employee.php?id=123)

Example .env file:

BAMBOOHR_TOKEN=your_api_token_here
BAMBOOHR_COMPANY_DOMAIN=yourcompany
BAMBOOHR_EMPLOYEE_ID=123