OneSignal MCP Server

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.

What is the rate limit for API requests?

OneSignal enforces a standard limit of 10 requests per second. Bulk operations may have lower limits.

Does the server handle errors?

Yes. All errors are returned in a standardized format with detailed messages, and automatic retry logic is provided for transient failures.