Can I use Clerk as a CLI?

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

Can I expose Clerk through MCP?

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

Where are Clerk credentials stored?

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

Can I deny write access for Clerk MCP tools?

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

other

Clerk CLI for Shell Scripts

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

7 functions 4 read 3 write API key auth

Submit Clerk feedback View package source

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

Command Shape

# Clerk CLI for Shell Scripts
kosmokrator integrations:configure clerk --set secret_key="$CLERK_SECRET_KEY" --enable --read allow --write ask --json
kosmo integrations:call clerk.clerk_list_users '{"limit":1,"offset":1,"email_address":"example_email_address","phone_number":"example_phone_number","query":"example_query","order_by":"example_order_by"}' --json

Discovery Before Execution

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

kosmo integrations:docs clerk --json
kosmo integrations:docs clerk.clerk_list_users --json
kosmo integrations:schema clerk.clerk_list_users --json
kosmo integrations:search "Clerk" --json
kosmo integrations:list --json

Useful Clerk CLI Functions

Function	Type	Parameters	Description
`clerk.clerk_list_users`	Read	limit, offset, email_address, phone_number, query, order_by	List users from Clerk with optional filtering and pagination. Returns user IDs, emails, names, and profile details.
`clerk.clerk_get_user`	Read	id	Retrieve a single Clerk user by their user ID. Returns full profile details including email, name, and metadata.
`clerk.clerk_create_user`	Write	email_address, first_name, last_name, password, username	Create a new user in Clerk. Requires at least one email address. Optionally set name, password, and username.
`clerk.clerk_update_user`	Write	id, first_name, last_name, username	Update an existing Clerk user's profile. Provide the user ID and fields to update.
`clerk.clerk_delete_user`	Write	id	Delete a user from Clerk. This action is irreversible and will remove all associated data.
`clerk.clerk_list_organizations`	Read	limit, offset, query	List organizations from Clerk with optional filtering and pagination. Returns organization IDs, names, and metadata.
`clerk.clerk_get_current_user`	Read	none	Health check — verify Clerk API connectivity by fetching the first user. Returns a single user or empty result to confirm the API is reachable.

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

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