Can I use Courier as a CLI?

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

Can I expose Courier through MCP?

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

Where are Courier credentials stored?

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

Can I deny write access for Courier MCP tools?

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

communication

Courier CLI for Coding Agents

Use the Courier CLI for coding agents with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write API key auth

Submit Courier feedback View package source

Courier CLI for Coding Agents

Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

Use this pattern when another coding agent needs exact commands and schema discovery. The Courier CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Courier CLI for Coding Agents
kosmokrator integrations:configure courier --set api_key="$COURIER_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call courier.courier_send_message '{"message":"example_message","recipient":"example_recipient"}' --json

Discovery Before Execution

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

kosmo integrations:docs courier --json
kosmo integrations:docs courier.courier_send_message --json
kosmo integrations:schema courier.courier_send_message --json
kosmo integrations:search "Courier" --json
kosmo integrations:list --json

Useful Courier CLI Functions

Function	Type	Parameters	Description
`courier.courier_send_message`	Write	message, recipient	Send a notification message through Courier. Provide a message payload with content or template, and a recipient (user ID, email, or recipient object). Supports all Courier send options including channels, routing, and preferences.
`courier.courier_list_messages`	Read	limit, cursor, status	List messages from Courier with optional filtering by status and cursor-based pagination. Returns message IDs, statuses, and metadata.
`courier.courier_get_message`	Read	id	Get detailed information about a specific Courier message, including delivery status, content, and channel details.
`courier.courier_list_recipients`	Read	limit, cursor	List notification recipients from Courier with cursor-based pagination. Returns recipient IDs, contact details, and preferences.
`courier.courier_get_recipient`	Read	id	Get detailed information about a specific Courier recipient, including contact preferences and channel profiles.
`courier.courier_list_templates`	Read	limit, cursor	List notification templates from Courier with cursor-based pagination. Returns template IDs, names, and metadata.
`courier.courier_get_current_user`	Read	none	Get the currently authenticated Courier user profile. Use this to verify the API key and see account information.

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

CI Courier CLI for CI. Cron Jobs Courier CLI for cron jobs. Shell Scripts Courier CLI for shell scripts. Headless Automation Courier CLI for headless automation.