Can I use BambooHR as a CLI?

Yes. KosmoKrator exposes a BambooHR CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose BambooHR through MCP?

Yes. The KosmoKrator MCP gateway can expose selected BambooHR tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are BambooHR credentials stored?

BambooHR credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for BambooHR MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

BambooHR MCP Gateway for AI Agents

Expose BambooHR tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

9 functions 7 read 2 write API key auth

Submit BambooHR feedback View package source

BambooHR MCP Gateway

Expose BambooHR to MCP clients with `kosmokrator mcp:serve --integration=bamboohr`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server. The gateway exposes only the selected integration in the example below.

curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

kosmokrator mcp:gateway:install --integration=bamboohr --write=deny --json

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

Serve Manually

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

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names:

MCP tool	Source function	Type
`integration__bamboohr__bamboohr_list_employees`	`bamboohr.bamboohr_list_employees`	Read `read`
`integration__bamboohr__bamboohr_get_employee`	`bamboohr.bamboohr_get_employee`	Read `read`
`integration__bamboohr__bamboohr_create_employee`	`bamboohr.bamboohr_create_employee`	Write `write`
`integration__bamboohr__bamboohr_update_employee`	`bamboohr.bamboohr_update_employee`	Write `write`
`integration__bamboohr__bamboohr_list_departments`	`bamboohr.bamboohr_list_departments`	Read `read`
`integration__bamboohr__bamboohr_list_time_off_requests`	`bamboohr.bamboohr_list_time_off_requests`	Read `read`
`integration__bamboohr__bamboohr_get_time_off_request`	`bamboohr.bamboohr_get_time_off_request`	Read `read`
`integration__bamboohr__bamboohr_list_reports`	`bamboohr.bamboohr_list_reports`	Read `read`
`integration__bamboohr__bamboohr_get_current_user`	`bamboohr.bamboohr_get_current_user`	Read `read`

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.