KosmoKrator

hr

BambooHR MCP Integration for Generic MCP Clients

Connect BambooHR to Generic MCP Clients through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

9 functions 7 read 2 write API key auth
Submit BambooHR feedback View package source

Connect BambooHR to Generic MCP Clients

Connect any stdio-compatible MCP client to local KosmoKrator integration tools.

Register kosmo mcp:serve as the command for a local stdio MCP server. The gateway is local, scoped to this integration, and starts with --write=deny so MCP clients can inspect read-capable tools without receiving write access by default.

BambooHR MCP Config for Generic MCP Clients

Start with read-only write policy and expand only for trusted projects.

{
  "mcpServers": {
    "kosmokrator-bamboohr": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=bamboohr",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=bamboohr --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only BambooHR instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

BambooHR Tools Visible to MCP clients

MCP clients sees stable MCP tool names generated from the BambooHR integration catalog.

MCP toolSource functionTypeDescription
integration__bamboohr__bamboohr_list_employees bamboohr.bamboohr_list_employees Read List employees from the BambooHR company directory. Returns employee names, job titles, departments, and other directory fields.
integration__bamboohr__bamboohr_get_employee bamboohr.bamboohr_get_employee Read Get detailed information for a specific BambooHR employee by ID. Optionally specify which fields to retrieve.
integration__bamboohr__bamboohr_create_employee bamboohr.bamboohr_create_employee Write Create a new employee in BambooHR. Provide employee data such as first name, last name, work email, job title, and department.
integration__bamboohr__bamboohr_update_employee bamboohr.bamboohr_update_employee Write Update an existing employee in BambooHR. Provide the employee ID and the fields to update.
integration__bamboohr__bamboohr_list_departments bamboohr.bamboohr_list_departments Read List all departments in the BambooHR company account.
integration__bamboohr__bamboohr_list_time_off_requests bamboohr.bamboohr_list_time_off_requests Read List time-off requests from BambooHR. Optionally filter by date range, status, or employee ID.
integration__bamboohr__bamboohr_get_time_off_request bamboohr.bamboohr_get_time_off_request Read Get detailed information for a specific BambooHR time-off request by its ID.
integration__bamboohr__bamboohr_list_reports bamboohr.bamboohr_list_reports Read Generate a custom report from BambooHR. Specify which employee fields to include in the report results.
integration__bamboohr__bamboohr_get_current_user bamboohr.bamboohr_get_current_user Read Get information about the currently authenticated BambooHR user.

Related BambooHR Pages

BambooHR CLIUse direct JSON commands instead of MCP discovery. BambooHR MCPFull gateway reference and MCP tool names. KosmoKrator for MCP clientsClient-level gateway setup.