Can I use Convex as a CLI?

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

Can I expose Convex through MCP?

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

Where are Convex credentials stored?

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

Can I deny write access for Convex MCP tools?

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

data

Convex CLI for Shell Scripts

Use the Convex CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 4 read 3 write Bearer token auth

Submit Convex feedback View package source

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

Command Shape

# Convex CLI for Shell Scripts
kosmokrator integrations:configure convex --set access_token="$CONVEX_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call convex.convex_list_tables '{}' --json

Discovery Before Execution

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

kosmo integrations:docs convex --json
kosmo integrations:docs convex.convex_list_tables --json
kosmo integrations:schema convex.convex_list_tables --json
kosmo integrations:search "Convex" --json
kosmo integrations:list --json

Useful Convex CLI Functions

Function	Type	Parameters	Description
`convex.convex_list_tables`	Read	none	List all tables in the Convex deployment.
`convex.convex_get_table`	Read	table	Get metadata and schema for a specific Convex table.
`convex.convex_query_documents`	Read	table, filter, order, limit, cursor	Query documents from a Convex table with optional filtering and pagination.
`convex.convex_create_document`	Write	table, fields	Create a new document in a Convex table.
`convex.convex_update_document`	Write	table, document_id, fields	Update an existing document in a Convex table.
`convex.convex_delete_document`	Write	table, document_id	Delete a document from a Convex table.
`convex.convex_get_current_user`	Read	none	Get the authenticated Convex user's profile information. Returns account details like name and email. Use this to verify API connectivity.

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

CI Convex CLI for CI. Cron Jobs Convex CLI for cron jobs. Headless Automation Convex CLI for headless automation. Coding Agents Convex CLI for coding agents.