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 Shell Scripts

Use the Bubble CLI for shell scripts 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 Shell Scripts

Call integration functions from shell scripts with stable JSON input and output.

Use shell scripts for small local automations that need one or more integration calls. 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 Shell Scripts
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. Headless Automation Bubble CLI for headless automation. Coding Agents Bubble CLI for coding agents.