BambooHR MCP

BambooHR MCP

MCP library for BambooHR enabling type-safe access to BambooHR API from Node.js/TypeScript

1
Stars
0
Forks
0
Releases

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.

Details

Owner
encoreshao
Language
TypeScript
License
MIT License
Updated
2025-12-07

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.

Tags

BambooHRMCPNode.jsTypeScriptHREmployee DirectoryTime TrackingAPI