productivity
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.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.
Agent Surfaces
Machine-Readable Metadata
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 | 7 | 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_cancel_notification | Write write | 2 | Cancel a scheduled or currently outgoing OneSignal message by ID. |
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. |
one-signal.onesignal_update_app | Write write | 2 | Update app configuration. This may require an organization-scoped API key. |
one-signal.onesignal_create_user | Write write | 2 | Create a OneSignal user with optional identity aliases, properties, and subscriptions. |
one-signal.onesignal_get_user | Read read | 3 | View a OneSignal user by alias, such as external_id or onesignal_id. |
one-signal.onesignal_update_user | Write write | 4 | Update user-level properties or deltas for a OneSignal user located by alias. |
one-signal.onesignal_delete_user | Write write | 3 | Delete a OneSignal user and all associated subscriptions by alias. |
one-signal.onesignal_get_user_identity | Read read | 3 | Fetch the identity aliases for a OneSignal user located by alias. |
one-signal.onesignal_create_or_update_alias | Write write | 4 | Create or update one or more identity aliases for a OneSignal user. |
one-signal.onesignal_delete_alias | Write write | 4 | Remove a specific alias from a OneSignal user without deleting the user. |
one-signal.onesignal_get_identity_by_subscription | Read read | 2 | Fetch the user identity aliases associated with a subscription ID. |
one-signal.onesignal_create_alias_by_subscription | Write write | 3 | Create or update aliases for the user associated with a known subscription ID. |
one-signal.onesignal_create_subscription | Write write | 4 | Create a subscription for a user identified by alias. |
one-signal.onesignal_update_subscription | Write write | 3 | Update a subscription by ID, such as tags, enabled state, or channel properties. |
one-signal.onesignal_transfer_subscription | Write write | 3 | Transfer a subscription to another user identity within the same app. |
one-signal.onesignal_list_segments | Read read | 3 | List segments for an app with pagination. |
one-signal.onesignal_get_segment | Read read | 3 | Get a segment by ID and optionally include segment filters. |
one-signal.onesignal_create_segment | Write write | 2 | Create a segment with name and filters. |
one-signal.onesignal_update_segment | Write write | 3 | Update a segment name or filters. |
one-signal.onesignal_delete_segment | Write write | 2 | Delete a segment by ID. |
one-signal.onesignal_list_templates | Read read | 3 | List message templates for an app with pagination. |
one-signal.onesignal_get_template | Read read | 2 | Get a message template by ID. |
one-signal.onesignal_create_template | Write write | 2 | Create a reusable push, email, or SMS template. |
one-signal.onesignal_update_template | Write write | 3 | Update a reusable push, email, or SMS template. |
one-signal.onesignal_delete_template | Write write | 2 | Delete a message template by ID. |
one-signal.onesignal_view_outcomes | Read read | 5 | View outcome analytics such as clicks, confirmed deliveries, session duration, or custom outcomes. |
one-signal.onesignal_api_get | Read read | 2 | Call a safe relative OneSignal API path with GET for endpoints not yet wrapped by a dedicated tool. |
one-signal.onesignal_api_post | Write write | 2 | Call a safe relative OneSignal API path with POST for endpoints not yet wrapped by a dedicated tool. |
one-signal.onesignal_api_patch | Write write | 2 | Call a safe relative OneSignal API path with PATCH for endpoints not yet wrapped by a dedicated tool. |
one-signal.onesignal_api_delete | Write write | 2 | Call a safe relative OneSignal API path with DELETE for endpoints not yet wrapped by a dedicated tool. |