Skip to main content
Switching between apps kills focus. With GAIA in Slack, you can manage todos, run workflows, check your calendar, and get answers, all without leaving the conversation you’re already in. Your team gets the same benefit. Add GAIA to a shared channel and everyone can ask questions, trigger automations, and stay on top of work together.

​
Connect Your GAIA Account

Before you can use GAIA in Slack, link your Slack identity to your GAIA account. You only need to do this once.
1

Open a DM with GAIA

Find the GAIA app in your Slack sidebar under Apps. If you don’t see it, click Add apps and search for GAIA. Open a direct message with the bot.
2

Run the auth command

Type this slash command in any channel or DM where GAIA is present:
GAIA sends you an ephemeral link. Only you can see it.
3

Log in and authorize

Click the link, sign in to your GAIA account in the browser, and authorize the connection. You’ll be redirected back automatically.
4

Confirm the link

Back in Slack, run /status to check that your account is connected. You should see a confirmation that the bot and API are online and your account is linked.
You can also connect Slack from the GAIA web app. Go to Settings > Integrations, find Slack, and click Connect. See the Connecting Integrations guide for details.

​
Talk to GAIA

There are three ways to reach GAIA in Slack.

​
Slash command

Use /gaia followed by your message in any channel or DM where the bot is installed:
GAIA posts a “Thinking…” message and updates it in real time as the response streams in.

​
@mention in a channel

In any channel GAIA has been added to, mention the bot directly:
The response appears in the channel for everyone to see, useful for team questions.

​
Direct message

Open a DM with GAIA and type freely. No slash command or @mention needed. Every message you send goes straight to GAIA, just like the web app.
Slash command responses are ephemeral, only you can see them. @mentions and DM replies are visible to everyone in the channel or conversation.

​
Commands Reference

Here are the most useful commands available in Slack. For the full list, see the Commands Reference.

​
Conversations

​
Todos

​
Workflows

​
Account

​
DMs vs Channels

GAIA behaves a little differently depending on where you talk to it. In DMs, every message you type goes straight to GAIA. No prefix needed. This is the best place for personal tasks, checking your calendar, managing todos, or asking questions you don’t want to share with the team. In channels, use /gaia or @GAIA to get the bot’s attention. This works better for team collaboration, asking GAIA to summarize a document, trigger a shared workflow, or answer a question the whole team needs to see.
Auth URLs and sensitive information are always sent as ephemeral messages (visible only to you), even in public channels. However, @mention responses are visible to everyone in the channel. Avoid sharing private data in channel mentions.

​
Tips for Team Use

​
Set up a dedicated channel

Create a #gaia channel and invite the bot. This gives your team one central place to work with GAIA without cluttering project channels.

​
Use workflows for recurring tasks

Instead of typing the same request every Monday morning, create a workflow in the GAIA web app and trigger it from Slack with /workflow execute <id>. Share workflow IDs with your team so anyone can run them.

​
Combine with integrations

GAIA gets more useful with every integration you connect. Link Google Calendar, Gmail, Linear, or GitHub, and Slack becomes a single interface for all of them.
Each team member needs to link their own GAIA account with /auth and connect their own integrations. GAIA respects individual permissions, it only accesses what each user has authorized.

​
Keep conversations organized

Use /new to start a fresh conversation when you switch topics. GAIA carries context within a conversation, so starting clean avoids confusion when you go from “plan my week” to “debug this API error.”

​
Troubleshooting

For developer setup and self-hosting instructions, see the Slack bot reference.