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, CLI, and Lua Integration for AI Agents

BambooHR integration docs for AI agents: MCP gateway setup, BambooHR CLI commands, Lua API reference, credentials, and function schemas.

9 functions 7 read 2 write API key auth

Submit BambooHR feedback View package source

BambooHR for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: bamboohr
route_slug: bamboohr
package: bamboohr
auth_strategy: api_key API key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. BambooHR CLIHeadless setup and direct function calls. BambooHR MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

BambooHR MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for BambooHR.

BambooHR CLI Matrix

Use these pages for direct BambooHR CLI workflows in scripts, CI, cron, and agent wrappers.

CI BambooHR CLI for CI. Cron Jobs BambooHR CLI for cron jobs. Shell Scripts BambooHR CLI for shell scripts. Headless Automation BambooHR CLI for headless automation. Coding Agents BambooHR CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`bamboohr.bamboohr_list_employees`	Read `read`	0	List employees from the BambooHR company directory. Returns employee names, job titles, departments, and other directory fields.
`bamboohr.bamboohr_get_employee`	Read `read`	2	Get detailed information for a specific BambooHR employee by ID. Optionally specify which fields to retrieve.
`bamboohr.bamboohr_create_employee`	Write `write`	9	Create a new employee in BambooHR. Provide employee data such as first name, last name, work email, job title, and department.
`bamboohr.bamboohr_update_employee`	Write `write`	9	Update an existing employee in BambooHR. Provide the employee ID and the fields to update.
`bamboohr.bamboohr_list_departments`	Read `read`	0	List all departments in the BambooHR company account.
`bamboohr.bamboohr_list_time_off_requests`	Read `read`	5	List time-off requests from BambooHR. Optionally filter by date range, status, or employee ID.
`bamboohr.bamboohr_get_time_off_request`	Read `read`	1	Get detailed information for a specific BambooHR time-off request by its ID.
`bamboohr.bamboohr_list_reports`	Read `read`	2	Generate a custom report from BambooHR. Specify which employee fields to include in the report results.
`bamboohr.bamboohr_get_current_user`	Read `read`	0	Get information about the currently authenticated BambooHR user.