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

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.

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

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

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
Advertise