OneSignal MCP Server

What it does

OneSignal is a customer engagement platform that lets you send targeted push notifications, emails, SMS, and in-app messages, manage audiences, and track campai

How to install the OneSignal MCP Server

Install it with one Smithery CLI line and enter the settings below when asked.

Claude Desktop

npx -y @smithery/cli install onesignal/onesignal --client claude

Cursor

npx -y @smithery/cli install onesignal/onesignal --client cursor

Remote server address (Streamable HTTP)

https://onesignal.run.tools

Keys and passwords go only to the provider and your own machine; ListeningMind never receives them.

34 tools

• 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.

Why it was picked · #50 · score 55

• Popularity (41%)77
• Trust (29%)80
• Member reviewsNot used this week
• Search demand (18%)0
• Search and AI Overview presence (12%)0

Source: Smithery · 22,491 uses · First picked 2026-10-23

Trust checks

• ✓ Verified at the source
• – In the official MCP Registry
• ✓ Own homepage
• ✓ Live endpoint
• ✓ Clear description

How we pick →

Made it? Add the badge to your README

[![ListeningMind pick](https://daas.listeningmind.ai/badge/mcps/x-mcp-onesignal-onesignal.svg)](https://daas.listeningmind.ai/en/catalog/mcps/x-mcp-onesignal-onesignal)

How to buy

Reviews ·

No reviews yet.

Questions people ask