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 MCP, CLI, and Lua Integration for AI Agents

Courier integration docs for AI agents: MCP gateway setup, Courier CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write API key auth

Submit Courier feedback View package source

Courier for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: courier
route_slug: courier
package: courier
auth_strategy: api_key API key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Courier CLIHeadless setup and direct function calls. Courier MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Courier MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Courier.

Claude Code Courier MCP setup for Claude Code. Cursor Courier MCP setup for Cursor. Codex Courier MCP setup for Codex. OpenAI Agents Courier MCP setup for OpenAI Agents SDK. Claude Agent SDK Courier MCP setup for Claude Agent SDK. Vercel AI SDK Courier MCP setup for Vercel AI SDK. LangChain Courier MCP setup for LangChain. LangGraph Courier MCP setup for LangGraph. CrewAI Courier MCP setup for CrewAI. MCP clients Courier MCP setup for Generic MCP Clients.

Courier CLI Matrix

Use these pages for direct Courier CLI workflows in scripts, CI, cron, and agent wrappers.

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. Coding Agents Courier CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`courier.courier_send_message`	Write `write`	2	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 `read`	3	List messages from Courier with optional filtering by status and cursor-based pagination. Returns message IDs, statuses, and metadata.
`courier.courier_get_message`	Read `read`	1	Get detailed information about a specific Courier message, including delivery status, content, and channel details.
`courier.courier_list_recipients`	Read `read`	2	List notification recipients from Courier with cursor-based pagination. Returns recipient IDs, contact details, and preferences.
`courier.courier_get_recipient`	Read `read`	1	Get detailed information about a specific Courier recipient, including contact preferences and channel profiles.
`courier.courier_list_templates`	Read `read`	2	List notification templates from Courier with cursor-based pagination. Returns template IDs, names, and metadata.
`courier.courier_get_current_user`	Read `read`	0	Get the currently authenticated Courier user profile. Use this to verify the API key and see account information.