OneSignal MCP Server
About
A Model Context Protocol (MCP) server for interacting with the OneSignal API
Details
- Author
- WeirdBrains
- GitHub stars
- 3
- Downloads
- 276
- Categories
- Other
Jump to
- Multi‑channel messaging: push, email, SMS, transactional messages
- Full CRUD for users, devices, and subscriptions
- Advanced segment creation with complex filters
- Template creation, update, and management
- iOS Live Activities (start, update, end)
- Analytics and CSV export for outcomes, players, messages
- Multi‑app support and organization‑level operations
- API key management: create, update, rotate, delete
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OneSignal MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server by cloning the repository from GitHub and installing dependencies with pip install -r requirements.txt. Configure your OneSignal credentials in a .env file (App ID, REST API Key, optionally Organization API Key). Run the server with python onesignal_server.py. The server then registers all 57 tools with the MCP system.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"onesignal mcp server": {
"onesignal-mcp": {
"command": "python",
"args": [
"onesignal_server.py"
]
}
}
}
}McpServers
{
"onesignal-mcp": {
"command": "python",
"args": [
"onesignal_server.py"
]
}
}OneSignal MCP Server
A comprehensive Model Context Protocol (MCP) server for interacting with the OneSignal API. This server provides a complete interface for managing push notifications, emails, SMS, users, devices, segments, templates, analytics, and more through OneSignal's REST API.
Overview
This MCP server provides comprehensive access to the OneSignal REST API, offering 57 tools that cover all major OneSignal operations:
🚀 Key Features
- Multi-channel Messaging: Send push notifications, emails, SMS, and transactional messages
- User & Device Management: Complete CRUD operations for users, devices, and subscriptions
- Advanced Segmentation: Create and manage user segments with complex filters
- Template System: Create, update, and manage message templates
- iOS Live Activities: Full support for iOS Live Activities
- Analytics & Export: View outcomes data and export to CSV
- Multi-App Support: Manage multiple OneSignal applications seamlessly
- API Key Management: Create, update, rotate, and delete API keys
- Organization-level Operations: Manage apps across your entire organization
Requirements
- Python 3.7 or higher
- python-dotenv package
- requests package
- mcp package
- OneSignal account with API credentials
Installation
Option 1: Clone from GitHub
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
