Advertise
MCP.so
Sign In

OneSignal MCP Server

@WeirdBrains

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

WeirdBrains

About OneSignal MCP Server

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

OneSignal MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

OneSignal MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

1

What are the runtime requirements?

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

2

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.

3

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.

4

What is the rate limit for API requests?

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

5

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.

Comments

More Other MCP servers

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Advertise