BambooHR MCP

What is BambooHR MCP?

BambooHR MCP is a Model Context Protocol library built with Node.js and TypeScript. It provides a clean, type-safe interface to interact with the BambooHR API, allowing developers to read and write HR data programmatically.

How to use BambooHR MCP?

Clone the repository, install dependencies with npm install, then set three environment variables: BAMBOOHR_TOKEN, BAMBOOHR_COMPANY_DOMAIN, and BAMBOOHR_EMPLOYEE_ID. Import helper functions like fetchEmployeeDirectory, fetchWhosOut, or submitWorkHours and call them with your credentials and domain.

Key features of BambooHR MCP

• TypeScript types for all models and API responses
• Simple, promise-based API for major BambooHR endpoints
• Easy to extend and integrate into existing projects
• Supports employee directory, who’s out, projects, time entries
• Work hours submission with project/task ID lookups

Use cases of BambooHR MCP

• Automate listing all employees with name, email, and job title
• Check who is out of office on a given day
• Submit work hours for a specific project and task
• Fetch and display time entries for reporting
• Integrate BambooHR data into custom HR dashboards

FAQ from BambooHR MCP

How do I create a BambooHR API token?

Log in to your BambooHR account, click your profile picture, select "API Keys", add a new key, and copy the generated token immediately (it is shown only once).

How do I find my company domain?

Your company domain is the subdomain used in your BambooHR URL. For https://yourcompany.bamboohr.com, the domain is yourcompany.

How do I get my employee ID?

Your employee ID appears in your BambooHR profile URL, for example https://yourcompany.bamboohr.com/employees/employee.php?id=123.

What environment variables are required?

You must set BAMBOOHR_TOKEN, BAMBOOHR_COMPANY_DOMAIN, and BAMBOOHR_EMPLOYEE_ID. These can also be passed directly to the API methods.

Where does data live and how is it transferred?

All data is stored in BambooHR’s cloud. The library communicates with the BambooHR REST API over HTTPS, using the API token for authentication.