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 CLI for Headless Automation

Use the BambooHR CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

9 functions 7 read 2 write API key auth

Submit BambooHR feedback View package source

BambooHR CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The BambooHR CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# BambooHR CLI for Headless Automation
kosmokrator integrations:configure bamboohr --set api_key="$BAMBOOHR_API_KEY" --set subdomain="$BAMBOOHR_SUBDOMAIN" --enable --read allow --write ask --json
kosmo integrations:call bamboohr.bamboohr_list_employees '{}' --json

Discovery Before Execution

Agents and scripts can inspect BambooHR docs and schemas before choosing a function.

kosmo integrations:docs bamboohr --json
kosmo integrations:docs bamboohr.bamboohr_list_employees --json
kosmo integrations:schema bamboohr.bamboohr_list_employees --json
kosmo integrations:search "BambooHR" --json
kosmo integrations:list --json

Useful BambooHR CLI Functions

Function	Type	Parameters	Description
`bamboohr.bamboohr_list_employees`	Read	none	List employees from the BambooHR company directory. Returns employee names, job titles, departments, and other directory fields.
`bamboohr.bamboohr_get_employee`	Read	employee_id, fields	Get detailed information for a specific BambooHR employee by ID. Optionally specify which fields to retrieve.
`bamboohr.bamboohr_create_employee`	Write	first_name, last_name, work_email, job_title, department, hire_date, status, location, supervisor_id	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	employee_id, first_name, last_name, work_email, job_title, department, status, location, supervisor_id	Update an existing employee in BambooHR. Provide the employee ID and the fields to update.
`bamboohr.bamboohr_list_departments`	Read	none	List all departments in the BambooHR company account.
`bamboohr.bamboohr_list_time_off_requests`	Read	start, end, status, employee_id, type_id	List time-off requests from BambooHR. Optionally filter by date range, status, or employee ID.
`bamboohr.bamboohr_get_time_off_request`	Read	request_id	Get detailed information for a specific BambooHR time-off request by its ID.
`bamboohr.bamboohr_list_reports`	Read	fields, title	Generate a custom report from BambooHR. Specify which employee fields to include in the report results.
`bamboohr.bamboohr_get_current_user`	Read	none	Get information about the currently authenticated BambooHR user.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related BambooHR CLI Pages

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