> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mythos.new/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mythos.new/_mcp/server.

# Connect your app to Slack

> Connect a bot from your Slack workspace to build notifications, channel dashboards, and team workflows.

[Slack](https://slack.com/) brings team conversations into channels. The Slack connector lets an app you build in Mythos post updates and use the conversations and workspace information that your bot is allowed to access.

Mythos uses a **bot token from a Slack app you have installed in your workspace**. Prepare that app in Slack, then save its token in Mythos. The connection can be used while building in the project chat and in your published app.

This page covers connecting your app to Slack. It does not set up a Mythos assistant inside Slack or install your generated app as a Slack agent.

With the connection, your app can:

* Send messages to channels and direct messages the bot can access.
* Read permitted channel history and workspace members.
* Schedule messages and edit or delete messages sent by the bot.
* Work with reactions, pins, bookmarks, and files where the token has the required scopes.
* Create or manage channels when the bot has permission.

## Examples to build

These prompts describe apps and workflows Mythos can build. Slack access comes from the bot; the dashboard, trigger, review step, or schedule comes from the app you request.

| App idea              | Prompt to try                                                                                                             | What it adds                                                               |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Enquiry notifications | *Post a short summary to our sales channel after a visitor submits the quote request form.*                               | A message connecting an app event to the team that should respond.         |
| Incident escalation   | *Add a Post alert button to our incident dashboard with severity, status, and a link to the incident.*                    | A deliberate escalation from an internal tool into Slack.                  |
| Channel digest        | *Build a digest tool for the channels our bot can read. Let me review the summary before posting it to the team.*         | A view that collects available messages and presents a draft for review.   |
| Weekly metrics        | *Build a report from our app's metrics and post a summary to the team channel every Monday morning.*                      | A scheduled reporting workflow with a clear source, destination, and time. |
| Project kickoff       | *Create a project setup form that makes a Slack channel, invites selected teammates, and posts the kickoff checklist.*    | A guided channel-creation workflow, subject to the bot's permissions.      |
| Message queue         | *Build a small admin tool to prepare Slack announcements, schedule them, and cancel scheduled messages before they send.* | A focused interface for the bot's outgoing messages.                       |

For a digest or any generated summary, keep a review step when accuracy matters. Specify the channel, time period, and the result you want so the app works with the right conversations.

## How Slack access works

Your bot token represents an installed Slack app in one Slack workspace. It acts as that bot and uses the scopes approved in Slack. Mythos does not add scopes or grant access to channels when you save the token.

Slack distinguishes permission to perform an action from access to a particular conversation. For example, a bot may have permission to read channel history but still need to join the channel. Private channels require an invitation.

## Connect Slack to Mythos

You need permission to install an app in the intended Slack workspace, or help from a Slack administrator, and permission to create connections in your Mythos workspace. If the right connection is already shared with you, use it rather than preparing another token.

### 1. Prepare the Slack app and bot token

1. Open your app in [Slack app settings](https://api.slack.com/apps), or create an app for the intended workspace.
2. Open **OAuth & Permissions** and add the **Bot Token Scopes** needed by your app.
3. Install the app to the workspace and approve those permissions. Your organization may require a Slack administrator's approval.
4. Copy the bot token from the app's OAuth settings. Bot tokens begin with `xoxb-`.

Useful scopes depend on the workflow:

| Workflow                                | Example bot scopes                                       |
| --------------------------------------- | -------------------------------------------------------- |
| List public channels                    | `channels:read`                                          |
| Read public channel history             | `channels:history`, with the bot in the channel          |
| Read private channels and their history | `groups:read` and `groups:history`, with the bot invited |
| Post messages                           | `chat:write`, with access to the destination             |
| List workspace members                  | `users:read`                                             |
| Add reactions                           | `reactions:write`                                        |

Choose the permissions needed for your app. If you add scopes later, complete Slack's installation or reauthorization process so the installed app receives them. See Slack's [app setup guide](https://docs.slack.dev/app-management/quickstart-app-settings/) and [token guide](https://docs.slack.dev/authentication/tokens/) for details.

### 2. Save the connection

1. From the Dashboard, open **Connectors** and select **Slack**. If no saved connection is available, the setup form opens.
2. Enter a **Display name**, such as `Team notifications`.
3. Paste the token into **Bot token**. Keep it out of chat messages and public files.
4. Under **Sharing**, keep it **Private** or choose **Share with others**. Grant access to selected members, or choose **Share with workspace**.
5. Click **Connect Slack**. Mythos checks the token with Slack before saving it.

Open **Chat actions (+) → Project connectors** in your project, select the saved Slack connection, and click **Use in this project**. Then describe the Slack feature you want Mythos to build. See [Connections in Mythos](/integrations/introduction) for project links and agent approval settings.

## Give the bot access to the right channels

Invite your own Slack app to the channels it should use. In Slack, enter `/invite` and select the app you installed. Use that app's name, which may differ from the connection's display name in Mythos.

For private channels, membership is required. Public-channel posting also depends on the bot's scopes and membership; saving a bot token does not grant universal access to public channels.

If Slack reports missing access, check both the scope and channel membership. If it reports a missing scope, update the Slack app's permissions and complete reauthorization. A successful token check identifies the app but does not confirm access to every channel or action.

## Limitations

* This setup uses your bot, not a personal Slack login. Do not expect it to search all of a user's private conversations. Slack's message search requires a user token and is not a capability to assume for this bot connection.
* Connecting the token does not subscribe your app to incoming mentions, direct messages, or interactive button events. Those require a separate receiving integration.
* Mythos does not create a Slack app, install it as an agent, or configure slash commands through this connection.
* Slack's rate limits, retention, workspace policies, and token permissions continue to apply.

## Manage the connection

Open **Connectors → Slack**, then the saved connection. **Linked projects → Unlink projects** removes selected project links. **Disconnect** stops Mythos from using the connection; it does not delete Slack conversations or uninstall your Slack app.

If the token is revoked or replaced in Slack, disconnect the old connection and connect Slack again with the new token. Link it to the intended projects, ask Mythos to set up the Slack features again, and publish the update. Features using the disconnected connection stop working until they are set up again.