> ## Documentation Index > Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt > Use this file to discover all available pages before exploring further. # Use OneSignal in Claude and ChatGPT > Connect OneSignal to Claude, Claude Cowork, ChatGPT, or Codex, then look up users, check message results, build segments and Journeys, and review email deliverability by asking in plain language. Connect OneSignal to the AI assistant you already use, then ask about your users and messages in plain language. Ask "Give me the delivery and click numbers for yesterday's push" or "Find this user and show me their subscriptions," and the assistant gets the answer from your OneSignal account. You install OneSignal from your assistant's own directory: the connectors directory in Claude, or the plugins directory in ChatGPT and Codex. You sign in with your OneSignal login, so there is no API key to copy. Setup takes a few minutes. > [!NOTE] > > [OneSignal AI](https://documentation.onesignal.com/docs/en/onesignal-ai.md) is the assistant built into the OneSignal dashboard. The OneSignal connector and plugin bring OneSignal into Claude and ChatGPT, where you may already do the rest of your work. ## Prerequisites * A OneSignal login with access to the apps you want to work with. * Claude or ChatGPT. On a business plan, your admin may need to allow OneSignal first. Each setup section below explains what to ask for. ## What you can ask Ask in your own words. You don't need special commands. Your assistant picks the right OneSignal action and shows you the result. **Look up users** * "Find the user with external ID `user_123` and list their subscriptions." * "Add the email address [jane@example.com](mailto:jane@example.com) to that user." **Check how messages performed** * "Show my last 10 messages and how each one performed." * "Give me the delivery and click numbers for yesterday's push." **Build segments and templates** * "Create a segment of users with the tag `plan` set to `premium`." * "List my email templates and show me the newest one." **Work with Journeys** * "How is my onboarding Journey performing, step by step?" * "Duplicate my welcome Journey as a new draft." **Check email deliverability** * "Is my sending domain set up correctly?" * "What are my bounce and spam complaint rates?" * "I'm about to email 500,000 people. Do I need to warm up first?" **Send messages** * "Send a push to my QA segment that says the sale starts at noon." **Export data** * "Export my subscribers to a CSV." See [every action OneSignal supports](https://documentation.onesignal.com/docs/en/model-context-protocol.md#tools). ## Connect OneSignal Pick your assistant and follow the steps. ### Claude and Claude Cowork **1. Open the connectors directory** In a chat, click **+** in the lower left (or type `/`). Hover over **Connectors** and select **Manage connectors**. Click **+** next to **Connectors**. You can also go to **Customize > Connectors**, or open [OneSignal in the Claude directory](https://claude.ai/directory/connectors/onesignal). **2. Connect OneSignal** Search for **OneSignal**, open it, and click **Connect**. **3. Sign in to OneSignal** Claude opens the OneSignal sign-in page in your browser. Sign in, review what Claude can do, and click **Agree & Allow Access**. **4. Turn OneSignal on in a chat** In a new chat, click **+**, hover over **Connectors**, and turn on **OneSignal**. The toggle applies to that conversation. After you connect, OneSignal is available in Claude on the web, Claude Desktop, Claude Cowork, and the Claude mobile apps. > [!NOTE] > > On a Claude Team or Enterprise plan, an Owner or Primary Owner of your Claude organization adds OneSignal for the organization before anyone can connect. If **Connect** isn't available, ask them to add it. If your organization allows connector requests, you can request OneSignal from its listing. ### ChatGPT and Codex **1. Open Plugins** In ChatGPT on the web or in the desktop app, open the **Plugins** tab. **2. Install OneSignal** Search for **OneSignal**, open its details, and select the **+** button to install it. **3. Sign in to OneSignal** ChatGPT asks you to sign in to OneSignal, either during install or the first time you use the plugin. Sign in, review what ChatGPT can do, and click **Agree & Allow Access**. **4. Ask OneSignal something** Start a new chat and ask your question. To make sure ChatGPT uses OneSignal, type `@` and pick **OneSignal**. The Codex app uses the same **Plugins** tab, so you install and use OneSignal there the same way. On ChatGPT mobile, you can use OneSignal once it's installed on your account. > [!NOTE] > > On a ChatGPT Business or Enterprise workspace, your workspace admin decides which plugins members can install. If you can't install OneSignal, ask your admin to make the OneSignal plugin available. ### Cursor, Claude Code, and other AI tools To connect OneSignal to Cursor, Claude Code, Codex CLI, or another AI tool, follow the [setup steps](https://documentation.onesignal.com/docs/en/model-context-protocol.md#set-up-your-ai-tool). ## Check that it works Ask your assistant: "Which OneSignal apps can I access?" The assistant lists the apps your OneSignal login can manage. If you have more than one app, name the app in your request, for example: "In my Production app, show my last 10 messages." ## Stay in control * `send_message` is marked as a high-impact action, so compatible AI clients may ask for confirmation before running it. * **Your login sets the limits.** Your assistant can see and change only what your OneSignal login can, in every app you have access to. * **You can disconnect at any time.** Go to **[Settings > Account settings > Connected apps](https://dashboard.onesignal.com/settings/connected-apps)** in OneSignal and revoke the connection. Revoking it doesn't affect your teammates' connections. ## Troubleshooting * **OneSignal doesn't show up in my Claude chat.** Click **+**, hover over **Connectors**, and turn on **OneSignal** for that chat. * **I can't connect or install OneSignal.** Your Claude organization or ChatGPT workspace may need an admin to allow it first. See the note in your assistant's setup section. * **The assistant says "tool access is not enabled for this application."** OneSignal hasn't turned on AI tool access for your OneSignal login yet. Contact OneSignal support. * **I see the wrong apps, or an app is missing.** You may be signed in with a different OneSignal login. Disconnect OneSignal in your assistant's connector or plugin settings, and sign out of OneSignal in your browser. Then connect again and sign in with the right login. * **I added OneSignal to Claude by URL before it was in the directory.** Remove that connector and connect again from the directory. * **Something else isn't working.** Disconnect and reconnect OneSignal, then start a new chat. ## FAQ ### Do I need to know what MCP is? No. MCP (Model Context Protocol) is the open standard that Claude and ChatGPT use to connect to other apps. The OneSignal connector and plugin use MCP behind the scenes. To connect a different app or set up the connection by hand, see [OneSignal MCP server](https://documentation.onesignal.com/docs/en/model-context-protocol.md). ### Does connecting OneSignal cost extra? Connecting OneSignal is free. Each action counts toward your normal OneSignal API usage limits. Your AI provider's plan may have its own costs. ### Can AI send notifications without my approval? `send_message` is marked as a high-impact action, and compatible AI clients may ask for confirmation before running it. Always review send requests before approving them in your AI client. ### Can I use it with more than one OneSignal app? Yes. One connection covers every app your OneSignal login can access. Name the app in your request so the assistant works in the right one. ### Can my teammates use my connection? No. Each person connects with their own OneSignal login, and each connection follows that person's access. ### Do I need an API key? No. You sign in with your OneSignal login in the browser. There is no API key to copy or store. ## Related pages > [card] [OneSignal MCP server](https://documentation.onesignal.com/docs/en/model-context-protocol.md) > > Connect Cursor, Claude Code, or another app, and see every supported action. > [card] [OneSignal AI](https://documentation.onesignal.com/docs/en/onesignal-ai.md) > > Use the assistant built into the OneSignal dashboard. > [card] [AI data practices](https://documentation.onesignal.com/docs/en/ai-data-practices.md) > > How OneSignal handles data for AI features and connected assistants. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.