KosmoKrator

hr

BambooHR MCP Integration for Claude Agent SDK

Connect BambooHR to Claude Agent SDK 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 Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

BambooHR MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Claude Agent SDK

Claude Agent SDK 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 Claude Agent SDKClient-level gateway setup.