• CLEANUP
  • AUDIT
  • LISTING
  • HUMAN

How to manage user segments and data with your AI

Connect OneSignal to your AI client once. After that, you can manage your audience and device records using plain text commands.

Ask AI about this page

Short answer

How can I manage OneSignal segments and data with my AI?

You can pull specific player details, list your app's players, or remove specific device records. This lets you clean up your audience and audit metadata without clicking through the OneSignal dashboard. You'll see exactly how the AI handles these requests below.

Data outcomes

Where your data goes.

The AI maps your commands to specific OneSignal actions.

CLEANUP

Purge old records

The AI removes specific device records from your OneSignal account. This keeps your segments accurate and reduces noise.

AUDIT

Check player data

You can pull detailed metadata for individual users. This helps you verify segment membership or troubleshoot targeting issues.

LISTING

View your audience

The AI pulls a list of players from your app. You can use this to get a high-level view of your current user base.

HUMAN

Manual segment creation

The AI cannot build complex segmentation logic or create new segments. You still handle the high-level strategy in the OneSignal dashboard.

The workflow

What your AI does when you ask for data.

The AI acts as a bridge between your chat interface and the OneSignal API.

  1. Identify users

    The AI scans your app's player list to find the specific individuals you want to target or clean up.

    list_app_players
  2. Inspect metadata

    Once a user is identified, the AI pulls their specific properties and device information.

    get_player_details
  3. Remove records

    If a device is stale or a user should be removed, the AI executes the deletion command.

    remove_player
  4. Confirm changes

    The AI reports back the results of the action so you know the record is gone or the data is updated.

    get_player_details

Try it

Copy these to start.

Use these prompts to trigger actions in OneSignal.

Starting points

These are basic starting points. Swap out the specific player IDs or app names with your actual OneSignal data.

OneSignal Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_n4u6ZwoMBcvPcOonEHoLz0ChyfNdoS0xpGNyovxL/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — OneSignal capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "onesignal-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_n4u6ZwoMBcvPcOonEHoLz0ChyfNdoS0xpGNyovxL/mcp"
    }
  }
}
Copy into chat04
  • List all the players in my mobile app.

  • Get the details for player ID 12345.

  • Remove the player with ID 67890 from my OneSignal account.

  • Show me the metadata for the user with this specific ID.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect OneSignal once, then ask.

Just link your account once. Your credentials stay encrypted, and you can immediately start managing your audience through your preferred AI client.

Connect OneSignal to your AI

FAQ

How this task behaves.

  • 01

    Can the AI create new segments for me?

    No. The AI can only read and remove existing player records. You must create segments within the OneSignal dashboard.

  • 02

    Will the AI delete my entire user list?

    No. The AI only removes specific players that you explicitly identify in your prompt.

  • 03

    Can I update user tags through the AI?

    No. The current tools only allow for listing players, getting details, and removing players.

  • 04

    Do I need to use the OneSignal dashboard for everything?

    No. You can use the AI to handle routine data cleanup and player lookups without opening the dashboard.

  • 05

    How does the AI know which player to remove?

    You must provide the specific player ID in your command so the AI can target the correct record.

  • More questions about OneSignal? See everything the OneSignal Connector can do

Connect OneSignal to Claude, Cursor, ChatGPT & more