home / mcp / bamboohr mcp server

BambooHR MCP Server

MCP server for BambooHR

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "evrimalacan-mcp-bamboohr": {
      "command": "npx",
      "args": [
        "mcp-bamboohr@latest"
      ],
      "env": {
        "BAMBOO_API_TOKEN": "your_actual_api_token",
        "BAMBOO_COMPANY_DOMAIN": "your_company_subdomain"
      }
    }
  }
}

This MCP Server enables your AI assistants to securely access BambooHR data through natural language queries. It streamlines employee information, time-off details, and company resources by exposing BambooHR data via an MCP interface that your AI tools can query directly.

How to use

You connect the BambooHR MCP Server to your MCP client to start querying BambooHR data through your AI assistants. Use the server to fetch detailed employee information, check time-off balances and requests, and access company files through natural language queries. When you issue a request, your MCP client translates it into the appropriate BambooHR API call and returns the results to you.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

1) Install the MCP BambooHR server dependencies and prepare the environment.

2) Start the MCP BambooHR server using the standard runtime command shown in the configuration example.

3) Verify the server starts without errors and confirm you can reach BambooHR with your API token.

Configuration details

{
  "mcpServers": {
    "bamboohr": {
      "command": "npx",
      "args": ["mcp-bamboohr@latest"],
      "type": "stdio",
      "env": {
        "BAMBOO_API_TOKEN": "your_actual_api_token",
        "BAMBOO_COMPANY_DOMAIN": "your_company_subdomain"
      }
    }
  }
}

Notes on security and usage

Keep your BambooHR API token secure. Do not share your token or embed it in client-side code. Use the provided environment variables to inject credentials at runtime. If you rotate tokens, update the corresponding environment variable in your MCP client configuration.

Troubleshooting

If you encounter authentication failures, verify that you are using the correct API token and that the company subdomain is set to the BambooHR subdomain (the part before .bamboohr.com). If access is forbidden, ensure your BambooHR account has API access enabled and the proper permissions for the requested resource. For resource-not-found errors, double-check the employee ID or resource you are requesting and confirm you have permission to access it.

Available tools

get-employee

Retrieve detailed employee information with customizable fields

get-employee-photo

Download employee photos in various sizes

get-employee-directory

Access the complete company directory

get-employee-goals

View performance goals and objectives

estimate-time-off-balance

Calculate future time off balances

get-time-off-requests

Retrieve and filter time off requests

get-whos-out

View upcoming time off and holidays

list-company-files

Browse available company files and categories

get-company-file

Download specific company documents

get-meta-fields

Discover all available BambooHR data fields