# OneSignal MCP 서버

> AI 어시스턴트로 푸시 알림, 이메일, SMS 메시지를 전송합니다.

- 가격: 무료로 연결 · 원 제공처 요금 별도
- URL: https://daas.listeningmind.ai/ko/catalog/mcps/x-mcp-onesignal-onesignal
- 출처: Smithery https://smithery.ai/server/onesignal/onesignal
- 이번 주 순위: #50 (score 55)

## 설치

```
npx -y @smithery/cli install onesignal/onesignal --client claude
```
- Remote: https://onesignal.run.tools

## 도구 (34)

- `create_alias_by_subscription`: Create or update identity aliases for the user who owns a given subscription. The onesignalid alias is read-only and must not be included.
- `create_custom_events`: Record custom events for OneSignal users, such as purchases, content views, or milestones. Use these to enter users into Journeys or trigger Wait Until nodes.
- `create_or_update_alias`: Create or update identity aliases for a user identified by alias. The onesignalid alias is read-only and must not be included.
- `create_segment`: Create a new audience segment with filter conditions. Maximum 200 filter entries.
- `create_subscription`: Create a new subscription and attach it to a user. Set type to the channel ("Email", "SMS", "iOSPush", "AndroidPush", etc.) and token to the email address, E.164 phone number, or p…
- `create_template`: Create a new notification template for a OneSignal app.
- `create_user`: Create a new user in a OneSignal app. Provide an identity (e.g. {"externalid": "user-123"}) so the user can be referenced later by alias.
- `export_audience_activity_csv`: Export audience activity for a notification to CSV. WARNING: Only 1 concurrent export is allowed per account — if a 409 or 429 is returned, a previous export is still running.
- `export_subscriptions_csv`: Export all subscriptions for a OneSignal app to CSV. WARNING: Only 1 concurrent export is allowed per account — if a 409 or 429 is returned, a previous export is still running.
- `get_custom_events`: List the custom event definitions indexed for a OneSignal app, including each event's properties, sources, most recent occurrence, usage locations (segment/journey), storage and to…
- `get_segment`: Retrieve a single audience segment by ID. By default, includes full segment metadata and filters (payload object with id, name, createdat, source, and filters).
- `get_template`: Retrieve a single notification template by ID.
- `get_user_identity`: Retrieve all identity aliases associated with a user. Identify the user by aliaslabel (typically "externalid") and aliasid.
- `get_user_identity_by_subscription`: Retrieve the identity aliases for the user who owns a given subscription.
- `list_apps`: List OneSignal apps accessible to the authenticated user. Returns app names, IDs, and organization info. Supports pagination via limit and offset parameters.
- `list_messages`: List push notifications for a OneSignal app. Use limit (default 50, max ~250) and offset for pagination.
- `list_segments`: List audience segments for a OneSignal app. Maximum 300 segments per page.
- `list_templates`: List notification templates for a OneSignal app. Maximum 50 per page.
- `onesignal_config`: Return the current OneSignal MCP server configuration and connected app details.
- `onesignal_health`: Check the health status of the OneSignal MCP server.
- `onesignal_reference_overview`: Return an overview of the OneSignal REST API reference, including available endpoints and rate limits.
- `send_message`: Send a push notification, email, or SMS via the OneSignal API. TIER 3 — HIGH IMPACT: confirmation is required before sending. Rate limited to 10 requests per minute.
- `start_live_activity`: Start an iOS Live Activity and deliver it to a specific device subscription.
- `transfer_subscription`: Transfer a subscription to a different user within the same app. Cross-app transfers are not supported. Rate limited to 1 request per second per subscription.
- `unsubscribe_email`: Unsubscribe an email address using the token from an email unsubscribe link. This endpoint uses token-based auth (no REST API key required).
- `update_live_activity`: Update or end an active iOS Live Activity.
- `update_segment`: Update an existing audience segment's name and/or filter conditions. name is always required even if not changing it (max 128 characters).
- `update_subscription`: Update an existing subscription (token, enabled status, or test type).
- `update_subscription_by_token`: Update a subscription identified by its channel type and token. Provide subscriptiontype and token to identify the subscription, then pass the fields to update in subscription.
- `update_template`: Update an existing notification template. The name field is required even if you are not changing it.
- `update_user`: Update an existing user identified by alias. Use properties to set tags, language, or country.
- `view_message`: Retrieve a single notification by ID.
- `view_outcomes`: Retrieve outcome statistics for a OneSignal app (e.g. click counts, session duration). Note: data retention is approximately 30 days.
- `view_user`: Retrieve a user and their properties by alias. Use aliaslabel "externalid" with the user's external ID, or another alias label you have configured.

## FAQ

### OneSignal MCP 서버는 무엇인가요?

AI 어시스턴트로 푸시 알림, 이메일, SMS 메시지를 전송합니다. Smithery에 등록된 항목으로, ListeningMind.AI가 매주 고르는 엄선 목록에서 50위(점수 55)입니다.

### OneSignal MCP 서버는 어떻게 설치하나요?

터미널에서 npx -y @smithery/cli install onesignal/onesignal --client claude 를 실행하면 Claude Desktop에 연결됩니다. Cursor는 --client cursor 로 바꿉니다.

### API 키가 필요한가요?

원 제공처 등록 정보에 필수 설정값이 없습니다.

### 어떤 도구를 제공하나요?

34개입니다: create_alias_by_subscription, create_custom_events, create_or_update_alias, create_segment, create_subscription, create_template, create_user, export_audience_activity_csv, export_subscriptions_csv, get_custom_events, get_segment, get_template.

### 요금은 얼마인가요?

무료로 연결 · 원 제공처 요금 별도. 사용료는 원 제공처 기준으로 따로 붙을 수 있습니다.

### 믿고 써도 되나요?

통과한 점검: 원 카탈로그 인증, 자체 홈페이지, 바로 연결되는 서버, 충분한 설명. 처음 쓰는 서버·저장소는 내용을 한번 확인한 뒤 연결하세요.