# OneSignal

OneSignal is an MCP server for Claude Code that sends push notifications, emails and SMS from an AI assistant. Describe the audience and message to send a campaign and view its stats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 22491 installs
- Author: onesignal
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/onesignal/onesignal
- Updated: 2026-03-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/onesignal

## What it does

This MCP server connects OneSignal to your coding agent. You describe who should get a message and what it says; the agent builds the filters, picks the template and calls `send_message`.\n\nThe toolset covers more than thirty operations: segments, templates, users, subscriptions, CSV exports of audience activity and subscriptions, plus delivery outcome stats. `onesignal_health` checks the server status and `onesignal_reference_overview` pulls up the REST API reference with rate limits. Sending a message requires confirmation first — it is a tier 3, high-impact tool limited to 10 requests per minute.\n\nCSV exports run one at a time per account. A 409 or 429 response means an earlier export is still running, so parallel automation jobs will collide.

## Requirements
- Remote server: `https://onesignal.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http onesignal https://onesignal.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add onesignal --url https://onesignal.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "onesignal": {
            "url": "https://onesignal.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "onesignal": {
            "type": "http",
            "url": "https://onesignal.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http onesignal https://onesignal.run.tools
```

## When to use it
- send a push campaign to a segment without opening the dashboard
- create an email template and launch a send from the agent chat
- export all app subscriptions to CSV through conversation
- pull delivery stats for one specific notification
- move a subscription to a different user in the same app

## Example prompts
- Send a push to Android users who opened the app in the last week
- Create a segment of users tagged `vip` and email them with the subject “20% off”
- Export all subscriptions for this app to CSV and show the first ten rows

## Similar
- [Pingram](https://affpapa.org/en/nevibecode/mcp/pingram.md) — MCP server
- [Courier MCP](https://affpapa.org/en/nevibecode/mcp/courier-mcp.md) — MCP server · 888 installs
- [knock-notification-best-practices](https://affpapa.org/en/nevibecode/skills/knock-notification-best-practices.md) — skill · 185 installs
- [Twilio SMS Automation](https://affpapa.org/en/nevibecode/skills/twilio-sms-automation.md) — skill · 5600 installs
- [twilio-notifications-alerts-advisor](https://affpapa.org/en/nevibecode/skills/twilio-notifications-alerts-advisor.md) — skill · ★ 8052 repo stars
- [Zoro](https://affpapa.org/en/nevibecode/mcp/zoro.md) — MCP server · 138 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
