Can I use OneSignal as a CLI?

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

Can I expose OneSignal through MCP?

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

Where are OneSignal credentials stored?

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

Can I deny write access for OneSignal MCP tools?

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

communication

OneSignal CLI for Headless Automation

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

7 functions 6 read 1 write API key auth

Submit OneSignal feedback View package source

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

Command Shape

# OneSignal CLI for Headless Automation
kosmokrator integrations:configure one-signal --set api_key="$ONE_SIGNAL_API_KEY" --set app_id="$ONE_SIGNAL_APP_ID" --enable --read allow --write ask --json
kosmo integrations:call one-signal.onesignal_list_notifications '{"app_id":"example_app_id","limit":1,"offset":1}' --json

Discovery Before Execution

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

kosmo integrations:docs one-signal --json
kosmo integrations:docs one-signal.onesignal_list_notifications --json
kosmo integrations:schema one-signal.onesignal_list_notifications --json
kosmo integrations:search "OneSignal" --json
kosmo integrations:list --json

Useful OneSignal CLI Functions

Function	Type	Parameters	Description
`one-signal.onesignal_list_notifications`	Read	app_id, limit, offset	List push notifications sent through OneSignal. Returns notification details including delivery stats, click counts, and outcomes. Use limit and offset for pagination.
`one-signal.onesignal_get_notification`	Read	id, app_id	Get details of a specific OneSignal push notification by its ID. Returns full notification data including content, delivery stats, and targeting.
`one-signal.onesignal_create_notification`	Write	app_id, contents, headings, included_segments, url, data	Send a new push notification via OneSignal. Specify message contents (per language), optional headings, target segments, a click URL, and a custom data payload.
`one-signal.onesignal_list_devices`	Read	app_id, limit, offset	List devices (players) registered in a OneSignal app. Returns device identifiers, platform, session counts, and tags. Use limit and offset for pagination.
`one-signal.onesignal_get_device`	Read	id, app_id	Get details of a specific OneSignal device (player) by its ID. Returns push token, platform, session data, tags, and more.
`one-signal.onesignal_list_apps`	Read	none	List all OneSignal apps accessible with the configured REST API key. Returns app names, IDs, player counts, and configuration.
`one-signal.onesignal_get_current_app`	Read	app_id	Get details of a specific OneSignal app by its ID. Returns app configuration, player counts, and platform settings.

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

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