Can I use Bubble as a CLI?

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

Can I expose Bubble through MCP?

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

Where are Bubble credentials stored?

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

Can I deny write access for Bubble MCP tools?

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

no-code

Bubble CLI for Headless Automation

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

5 functions 2 read 3 write API key auth

Submit Bubble feedback View package source

Bubble 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 Bubble CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Bubble CLI for Headless Automation
kosmokrator integrations:configure bubble --set api_key="$BUBBLE_API_KEY" --set hostname="$BUBBLE_HOSTNAME" --enable --read allow --write ask --json
kosmo integrations:call bubble.bubble_list_records '{"type":"example_type","constraints":"example_constraints","limit":1,"cursor":1}' --json

Discovery Before Execution

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

kosmo integrations:docs bubble --json
kosmo integrations:docs bubble.bubble_list_records --json
kosmo integrations:schema bubble.bubble_list_records --json
kosmo integrations:search "Bubble" --json
kosmo integrations:list --json

Useful Bubble CLI Functions

Function	Type	Parameters	Description
`bubble.bubble_list_records`	Read	type, constraints, limit, cursor	List records from a Bubble data type. Supports filtering with constraints, pagination with limit and cursor. Returns matching records and a remaining count for further pagination.
`bubble.bubble_get_record`	Read	type, id	Get a single record from Bubble by its data type and unique ID. Returns all fields of the record.
`bubble.bubble_create_record`	Write	type, fields	Create a new record in a Bubble data type. Provide field names and values as a JSON object. Returns the created record including its generated ID.
`bubble.bubble_update_record`	Write	type, id, fields	Update an existing record in Bubble by its data type and unique ID. Only the fields provided will be changed; other fields remain unchanged. Returns the updated record.
`bubble.bubble_delete_record`	Write	type, id	Delete a record from Bubble by its data type and unique ID. This action is permanent and cannot be undone.

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 Bubble CLI Pages

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