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 Headless Automation

Use the Courier CLI for headless automation 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 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 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 Headless Automation
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. Coding Agents Courier CLI for coding agents.