Can I use Novu as a CLI?

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

Can I expose Novu through MCP?

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

Where are Novu credentials stored?

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

Can I deny write access for Novu MCP tools?

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

communication

Novu CLI for Headless Automation

Use the Novu CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 5 read 2 write API key auth

Submit Novu feedback View package source

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

Command Shape

# Novu CLI for Headless Automation
kosmokrator integrations:configure novu --set api_key="$NOVU_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call novu.novu_list_notifications '{"page":1,"limit":1,"channel":"example_channel"}' --json

Discovery Before Execution

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

kosmo integrations:docs novu --json
kosmo integrations:docs novu.novu_list_notifications --json
kosmo integrations:schema novu.novu_list_notifications --json
kosmo integrations:search "Novu" --json
kosmo integrations:list --json

Useful Novu CLI Functions

Function	Type	Parameters	Description
`novu.novu_list_notifications`	Read	page, limit, channel	List notifications from Novu. Returns a paginated list of notifications, optionally filtered by channel (e.g., in_app, email, sms, chat, push).
`novu.novu_get_notification`	Read	id	Get details of a specific notification in Novu by its ID. Returns the full notification object including status, channel data, and content.
`novu.novu_list_subscribers`	Read	page, limit	List subscribers from Novu. Returns a paginated list of all notification subscribers with their details.
`novu.novu_get_subscriber`	Read	id	Get details of a specific subscriber in Novu by their ID. Returns the subscriber profile including email, phone, and preferences.
`novu.novu_create_subscriber`	Write	email, firstName, lastName, phone	Create a new subscriber in Novu. Requires an email address. Optionally include first name, last name, and phone number.
`novu.novu_trigger_event`	Write	name, to, payload	Trigger a notification event in Novu. Sends a notification based on a workflow template to one or more subscribers. The "to" field can be a subscriber ID, email address, or an array of recipients.
`novu.novu_get_current_user`	Read	none	Get the currently authenticated Novu user. Returns user profile information including name, email, and organization details.

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

CI Novu CLI for CI. Cron Jobs Novu CLI for cron jobs. Shell Scripts Novu CLI for shell scripts. Coding Agents Novu CLI for coding agents.