communication
OneSignal MCP, CLI, and Lua Integration for AI Agents
OneSignal integration docs for AI agents: MCP gateway setup, OneSignal CLI commands, Lua API reference, credentials, and function schemas.
7 functions 6 read 1 write API key auth
OneSignal 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
one-signal- route_slug
one-signal- package
one-signal- auth_strategy
api_keyAPI 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. OneSignal CLIHeadless setup and direct function calls. OneSignal 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.
OneSignal MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for OneSignal.
Claude Code OneSignal MCP setup for Claude Code. Cursor OneSignal MCP setup for Cursor. Codex OneSignal MCP setup for Codex. OpenAI Agents OneSignal MCP setup for OpenAI Agents SDK. Claude Agent SDK OneSignal MCP setup for Claude Agent SDK. Vercel AI SDK OneSignal MCP setup for Vercel AI SDK. LangChain OneSignal MCP setup for LangChain. LangGraph OneSignal MCP setup for LangGraph. CrewAI OneSignal MCP setup for CrewAI. MCP clients OneSignal MCP setup for Generic MCP Clients.
OneSignal CLI Matrix
Use these pages for direct OneSignal CLI workflows in scripts, CI, cron, and agent wrappers.
CI OneSignal CLI for CI. Cron Jobs OneSignal CLI for cron jobs. Shell Scripts OneSignal CLI for shell scripts. Headless Automation OneSignal CLI for headless automation. Coding Agents OneSignal CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
one-signal.onesignal_list_notifications | Read read | 3 | 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 read | 2 | 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 write | 6 | 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 read | 3 | 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 read | 2 | 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 read | 0 | 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 read | 1 | Get details of a specific OneSignal app by its ID. Returns app configuration, player counts, and platform settings. |