OneSignal MCP Server logo

OneSignal MCP Server

by WeirdBrains

A Model Context Protocol (MCP) server for interacting with the OneSignal API. This server provides a convenient interface for managing push notifications, emails, SMS, user devices, segments, templates, and more through OneSignal's REST API.

View on GitHub

Last updated: N/A

What is OneSignal MCP Server?

This MCP server wraps the OneSignal REST API to provide a set of tools for managing your OneSignal applications and sending messages to your users. It supports all major OneSignal operations.

How to use OneSignal MCP Server?

  1. Clone the repository or install the package (when available).
  2. Configure your OneSignal credentials in a .env file.
  3. Run the server using python onesignal_server.py.
  4. Use the available tools via API calls to manage notifications, devices, segments, and templates.

Key features of OneSignal MCP Server

  • Sending push notifications, emails, and SMS

  • Managing user devices and subscriptions

  • Creating and managing segments

  • Creating and managing templates

  • Viewing app information and analytics

  • Organization-level operations

  • Managing multiple OneSignal applications

Use cases of OneSignal MCP Server

  • Automated marketing campaigns via push, email, and SMS

  • Personalized user engagement based on segments

  • Efficient management of multiple OneSignal applications

  • Streamlined template creation and management for consistent messaging

FAQ from OneSignal MCP Server

How do I configure my OneSignal credentials?

Create a .env file in the root directory and set the ONESIGNAL_APP_ID, ONESIGNAL_API_KEY, and ONESIGNAL_ORG_API_KEY environment variables.

How do I manage multiple OneSignal applications?

Use the add_app, switch_app, update_app, and remove_app tools to manage multiple app configurations.

What types of messages can I send?

You can send push notifications, emails, and SMS messages using the send_notification tool.

How do I create a new segment?

Use the create_segment tool and specify the segment name and filters.

Where can I find more information about the OneSignal API?

Refer to the OneSignal API Documentation: https://documentation.onesignal.com/reference