OneSignal — Claude Code MCP server for push, email and SMS
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.
no license 22,491 installs updated 2026-03-10
claude mcp add --transport http onesignal https://onesignal.run.toolsWhat OneSignal 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.
What it helps with
- 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 for the agent
- Send a push to Android users who opened the app in the last week
- Create a segment of users tagged
vipand email them with the subject “20% off” - Export all subscriptions for this app to CSV and show the first ten rows
How to install OneSignal
Platform CLI: remote server
claude mcp add --transport http onesignal https://onesignal.run.toolsPlatform CLI: remote server
codex mcp add onesignal --url https://onesignal.run.toolsConfig file
{
"mcpServers": {
"onesignal": {
"url": "https://onesignal.run.tools"
}
}
}Config file
{
"servers": {
"onesignal": {
"type": "http",
"url": "https://onesignal.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http onesignal https://onesignal.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OneSignal
How do I install the OneSignal MCP server in Claude Code?
Run claude mcp add --transport http onesignal https://onesignal.run.tools. The server then appears in your Claude Code MCP connections.
What does the OneSignal MCP server do?
It wires OneSignal into an AI assistant: sending push, email and SMS, building segments, managing templates and subscriptions, and checking campaign outcomes — all from natural-language instructions.
What limits apply to sending messages?
send_message requires confirmation before it fires. It is rate limited to 10 requests per minute, up to 20,000 users per call and a maximum of 200 filter entries.