OneSignal MCP Server

Name: OneSignal MCP Server
Author: WeirdBrains

@WeirdBrains

代码仓库

关于 OneSignal MCP Server

A Model Context Protocol (MCP) server for interacting with the OneSignal API

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

WeirdBrains

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "onesignal-mcp": {
      "command": "python",
      "args": [
        "onesignal_server.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is OneSignal MCP Server?

OneSignal MCP Server is a comprehensive Model Context Protocol server that provides a complete interface for managing push notifications, emails, SMS, users, devices, segments, templates, analytics, and more through the OneSignal REST API. It offers 57 tools and is intended for developers integrating OneSignal into AI‑assisted workflows.

How to use OneSignal MCP Server?

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.

Key features of OneSignal MCP Server

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

Use cases of OneSignal MCP Server

Send push notifications to segmented user groups from an AI assistant
Manage user profiles and device subscriptions programmatically
Create and update message templates for multi‑channel campaigns
Monitor campaign performance by viewing outcomes and exporting data
Automate iOS Live Activity lifecycle for real‑time updates

FAQ from OneSignal MCP Server

What are the runtime requirements?

Python 3.7 or higher, plus the python-dotenv, requests, and mcp packages.

How do I get my OneSignal credentials?

Find your App ID and REST API Key under Settings > Keys & IDs. The Organization API Key is under Organization Settings > API Keys.

Can I manage multiple OneSignal apps?

Yes. The server supports multi‑app configurations via environment variables and includes tools to list, add, update, and switch between app configurations.