KosmoKrator

hr

BambooHR MCP Integration for Claude Code

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

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

BambooHR MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

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

Claude Code 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 CodeClient-level gateway setup.