KosmoKrator

hr

BambooHR MCP Integration for LangChain

Connect BambooHR to LangChain 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 LangChain

Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls.

Use the MCP gateway when the agent should discover tools, or wrap kosmo integrations:call for fixed chains. The gateway is local, scoped to this integration, and starts with --write=deny so LangChain can inspect read-capable tools without receiving write access by default.

BambooHR MCP Config for LangChain

Keep the gateway scoped to the integration and operation class needed by the chain.

{
  "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 LangChain

LangChain 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 LangChainClient-level gateway setup.