# OneSignal MCP Server > OneSignal is a customer engagement platform that lets you send targeted push notifications, emails, SMS, and in-app messages, manage audiences, and track campai - Price: Free to connect · provider's own fees apply - URL: https://daas.listeningmind.ai/en/catalog/mcps/x-mcp-onesignal-onesignal - Source: Smithery https://smithery.ai/server/onesignal/onesignal - Rank this week: #50 (score 55) ## Install ``` npx -y @smithery/cli install onesignal/onesignal --client claude ``` - Remote: https://onesignal.run.tools ## Tools (34) - `create_alias_by_subscription`: Create or update identity aliases for the user who owns a given subscription. The onesignalid alias is read-only and must not be included. - `create_custom_events`: Record custom events for OneSignal users, such as purchases, content views, or milestones. Use these to enter users into Journeys or trigger Wait Until nodes. - `create_or_update_alias`: Create or update identity aliases for a user identified by alias. The onesignalid alias is read-only and must not be included. - `create_segment`: Create a new audience segment with filter conditions. Maximum 200 filter entries. - `create_subscription`: Create a new subscription and attach it to a user. Set type to the channel ("Email", "SMS", "iOSPush", "AndroidPush", etc.) and token to the email address, E.164 phone number, or p… - `create_template`: Create a new notification template for a OneSignal app. - `create_user`: Create a new user in a OneSignal app. Provide an identity (e.g. {"externalid": "user-123"}) so the user can be referenced later by alias. - `export_audience_activity_csv`: Export audience activity for a notification to CSV. WARNING: Only 1 concurrent export is allowed per account — if a 409 or 429 is returned, a previous export is still running. - `export_subscriptions_csv`: Export all subscriptions for a OneSignal app to CSV. WARNING: Only 1 concurrent export is allowed per account — if a 409 or 429 is returned, a previous export is still running. - `get_custom_events`: List the custom event definitions indexed for a OneSignal app, including each event's properties, sources, most recent occurrence, usage locations (segment/journey), storage and to… - `get_segment`: Retrieve a single audience segment by ID. By default, includes full segment metadata and filters (payload object with id, name, createdat, source, and filters). - `get_template`: Retrieve a single notification template by ID. - `get_user_identity`: Retrieve all identity aliases associated with a user. Identify the user by aliaslabel (typically "externalid") and aliasid. - `get_user_identity_by_subscription`: Retrieve the identity aliases for the user who owns a given subscription. - `list_apps`: List OneSignal apps accessible to the authenticated user. Returns app names, IDs, and organization info. Supports pagination via limit and offset parameters. - `list_messages`: List push notifications for a OneSignal app. Use limit (default 50, max ~250) and offset for pagination. - `list_segments`: List audience segments for a OneSignal app. Maximum 300 segments per page. - `list_templates`: List notification templates for a OneSignal app. Maximum 50 per page. - `onesignal_config`: Return the current OneSignal MCP server configuration and connected app details. - `onesignal_health`: Check the health status of the OneSignal MCP server. - `onesignal_reference_overview`: Return an overview of the OneSignal REST API reference, including available endpoints and rate limits. - `send_message`: Send a push notification, email, or SMS via the OneSignal API. TIER 3 — HIGH IMPACT: confirmation is required before sending. Rate limited to 10 requests per minute. - `start_live_activity`: Start an iOS Live Activity and deliver it to a specific device subscription. - `transfer_subscription`: Transfer a subscription to a different user within the same app. Cross-app transfers are not supported. Rate limited to 1 request per second per subscription. - `unsubscribe_email`: Unsubscribe an email address using the token from an email unsubscribe link. This endpoint uses token-based auth (no REST API key required). - `update_live_activity`: Update or end an active iOS Live Activity. - `update_segment`: Update an existing audience segment's name and/or filter conditions. name is always required even if not changing it (max 128 characters). - `update_subscription`: Update an existing subscription (token, enabled status, or test type). - `update_subscription_by_token`: Update a subscription identified by its channel type and token. Provide subscriptiontype and token to identify the subscription, then pass the fields to update in subscription. - `update_template`: Update an existing notification template. The name field is required even if you are not changing it. - `update_user`: Update an existing user identified by alias. Use properties to set tags, language, or country. - `view_message`: Retrieve a single notification by ID. - `view_outcomes`: Retrieve outcome statistics for a OneSignal app (e.g. click counts, session duration). Note: data retention is approximately 30 days. - `view_user`: Retrieve a user and their properties by alias. Use aliaslabel "externalid" with the user's external ID, or another alias label you have configured. ## FAQ ### What is the OneSignal MCP Server? OneSignal is a customer engagement platform that lets you send targeted push notifications, emails, SMS, and in-app messages, manage audiences, and track campai. It is listed on Smithery and ranks #50 (score 55) in ListeningMind.AI's weekly picks. ### How do I install the OneSignal MCP Server? Run npx -y @smithery/cli install onesignal/onesignal --client claude in a terminal to add it to Claude Desktop. For Cursor, use --client cursor. ### Do I need an API key? The provider lists no required settings. ### Which tools does it provide? 34 tools: create_alias_by_subscription, create_custom_events, create_or_update_alias, create_segment, create_subscription, create_template, create_user, export_audience_activity_csv, export_subscriptions_csv, get_custom_events, get_segment, get_template. ### How much does it cost? Free to connect · provider's own fees apply. The provider may charge for use on its own terms. ### Can I trust it? Checks passed: Verified at the source, Own homepage, Live endpoint, Clear description. Skim a server or repository you have not used before connecting it.