Overview
BambooHR MCP is a Model Context Protocol library for BambooHR, built with Node.js and TypeScript. It provides a clean, type-safe interface to interact with the BambooHR API from Node.js or TypeScript applications. The library ships with TypeScript types for all models and API responses and a simple, promise-based API covering major BambooHR endpoints. It exposes a BambooHRApi class that encapsulates all API methods and helper functions such as fetchWhosOut, fetchProjects, submitWorkHours, getMe, fetchEmployeeDirectory, and fetchTimeEntries. All methods return Promises and rely on types defined in src/utils/models.d.ts. Installation is straightforward: clone the repo, install dependencies with npm install. The README includes usage examples for listing employee directories, querying who's out today, and submitting work hours after selecting project and task IDs. Environment configuration supports passing a BambooHR token, company domain, and employee ID directly or via environment variables BAMBOOHR_TOKEN, BAMBOOHR_COMPANY_DOMAIN, and BAMBOOHR_EMPLOYEE_ID. Extending the library is simply done by adding new methods in src/apis/bamboohr.ts and exporting them from src/index.ts. The project is MIT licensed.
Features
Type-safe TypeScript types
TypeScript types for all models and API responses to ensure compile-time safety.
Promise-based API
Simple, promise-based API for all major BambooHR endpoints.
Extensible and integrable
Easy to extend and integrate into your own projects.
BambooHRApi class encapsulation
BambooHRApi class encapsulates all API methods for convenient usage.




