KosmoKrator

hr

BambooHR MCP Integration for LangGraph

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

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

BambooHR MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

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

LangGraph 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 LangGraphClient-level gateway setup.