Notification Settings

Configure notification channels, manage alert types, and control how GAIA notifies you across in-app, Telegram, Discord, and mobile push.

How GAIA Notifications Work

GAIA notifies you when something needs your attention. An email draft is ready to send. A reminder you set just fired. A background workflow finished. Each notification shows up in real time, and many include action buttons so you can respond without navigating away.

There are four types of notifications:

AI-Generated Actions

Email drafts, calendar events, and tasks that GAIA created on your behalf. These include action buttons so you can confirm, edit, or dismiss right from the notification.

Reminders

Time-based alerts you asked GAIA to set. They fire at the scheduled time and often include follow-up actions like marking a task complete.

Workflow Updates

Status updates when a background workflow finishes or fails. Useful when you’ve kicked off an automation and want to know when it’s done.

System Notifications

Account-level updates like a new integration being connected or a background job completing.

Notification Channels

GAIA can notify you across multiple channels at once. Each one can be toggled independently.

Channel	Where it appears	Enabled by default
In-app	Notification panel inside the GAIA web and mobile apps	Always on
Telegram	Direct message from the GAIA Telegram bot	Yes (requires linked account)
Discord	Direct message from the GAIA Discord bot	Yes (requires linked account)
Push (mobile)	Native push notification on your phone	Yes (after granting permission)

In-app notifications are always on and can’t be turned off. They’re the baseline — so you never miss something important even if other channels are disabled.

Configure Channel Preferences

1. Open Notification Settings

   Go to Settings > Notifications in the sidebar. You’ll see each notification channel listed with a toggle.

   
2. Toggle channels on or off

   Flip the switch next to any platform to turn it on or off. Changes save automatically.

   Telegram and Discord toggles only appear after you’ve linked those accounts. If you see “Connect in Linked Accounts to enable,” go to Settings > Linked Accounts first.

3. Link external accounts (if needed)

   To get Telegram or Discord notifications, connect those platforms under Settings > Linked Accounts. Once linked, come back to Notification Settings and toggle them on.

Keep at least one external channel enabled — Telegram or Discord — so you get notified even when you’re not actively using the GAIA app.

Push Notifications on Mobile

The GAIA mobile app uses native push notifications via Expo. The first time you open the app, it asks for permission to send notifications.

Enable push notifications

1. Open the GAIA mobile app and sign in.
2. Accept the notification permission prompt when it appears.
3. Your device is automatically registered with GAIA’s notification service.

Push notifications include sound and badge updates by default. Tapping one takes you directly to what triggered it — a todo, a workflow, or a conversation.

If you denied the permission prompt, you’ll need to turn notifications on manually in your device’s system settings under the GAIA app.

Managing devices

You can register up to 10 devices for push notifications. If you switch phones or want to stop notifications on a specific device, sign out of the GAIA app on that device. It unregisters automatically.

Managing Notification Noise

A proactive assistant can generate a lot of notifications. Here’s how to stay on top of them without feeling buried.

Use bulk actions

Open the notification panel and select multiple notifications to mark them read or archive them in one step. Much faster than handling them one by one.

Act on notifications inline

Many notifications include action buttons — “Preview & Send” on an email draft, “View Task” on a new todo, “Confirm Event” on a calendar suggestion. Use these to handle things right from the notification instead of digging into the full feature.

Archive what you’ve handled

After you act on a notification, archive it. Archived notifications are hidden from the default view but stay accessible if you need to look something up later.

Clear your notifications at the end of each day. A clean panel makes it easy to spot what actually needs your attention.

Notification Actions

GAIA notifications are interactive. Depending on what triggered them, you’ll see action buttons that let you respond directly:

Source	Available Actions
Email draft	Preview & Send (opens an editor so you can review and send the draft)
Calendar event	Confirm Event (creates the event on your calendar)
New task	View Task, Mark Complete
Reminder	Context-specific actions based on what the reminder is about
Workflow	More Details (takes you to the workflow or conversation)

Actions that write data — like confirming an event or completing a task — can only run once. The button disables after you use it to prevent duplicates.

If an action fails, you’ll see an error message. Retry by going to the relevant page (Todos, Calendar, etc.) and performing the action from there.