> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack (Official)

> Official Slack MCP server hosted by Slack

<Info>
  **Hosted by a third party.** This MCP server is built and hosted by the
  vendor, not Runlayer. This guide covers connecting it through Runlayer for
  governance, policies, and audit.
</Info>

Connect your AI assistant to [Slack](https://slack.com) using Slack's official MCP server. Features messaging, search, Canvas documents, and scheduled messages.

## Available Tools

| Tool                              | Description                               |
| --------------------------------- | ----------------------------------------- |
| `slack_send_message`              | Send messages to channels or users        |
| `slack_schedule_message`          | Schedule messages for future delivery     |
| `slack_create_canvas`             | Create Slack Canvas documents             |
| `slack_read_canvas`               | Read Canvas document content              |
| `slack_search_public`             | Search messages/files in public channels  |
| `slack_search_public_and_private` | Search all channels including private/DMs |
| `slack_search_channels`           | Find channels by name or description      |
| `slack_search_users`              | Find users by name, email, or profile     |
| `slack_read_channel`              | Read messages from a channel              |
| `slack_read_thread`               | Read messages from a thread               |
| `slack_read_user_profile`         | Get user profile information              |
| `slack_send_message_draft`        | Create draft messages                     |

## Setup

<Steps>
  <Step title="Create Slack App from Manifest">
    1. Go to [Slack API: Applications](https://api.slack.com/apps)
    2. Click **Create New App** > **From a manifest**
    3. Select your workspace and click **Next**
    4. Paste this manifest (replace `<your-tenant>` with your Runlayer subdomain):

    ```yaml theme={null}
    display_information:
      name: Runlayer Slack MCP
      description: Official Slack MCP via Runlayer
      background_color: "#2c2d30"
    features:
      bot_user:
        display_name: Slack MCP
        always_online: false
    oauth_config:
      redirect_urls:
        - https://<your-tenant>.runlayer.com/oauth/callback
      scopes:
        user:
          - chat:write
          - channels:read
          - channels:history
          - groups:read
          - groups:history
          - mpim:read
          - mpim:history
          - im:read
          - im:history
          - canvases:read
          - canvases:write
          - users:read
          - users:read.email
          - search:read.public
          - search:read.private
          - search:read.mpim
          - search:read.im
          - search:read.files
          - search:read.users
        bot:
          - commands
    settings:
      org_deploy_enabled: true
      socket_mode_enabled: false
      token_rotation_enabled: false
    ```

    <Note>
      The bot user and `commands` scope are required by Slack for org-wide installs but are unused by Runlayer.
    </Note>

    5. Click **Next**, review the summary, then click **Create**
  </Step>

  <Step title="Enable MCP">
    1. In your app settings, go to **Agents & AI Apps** in the sidebar
    2. Enable **MCP Server** for your app
  </Step>

  <Step title="Install App to Workspace">
    1. Go to **Settings** > **Install App** in the sidebar
    2. Click **Install to Workspace/Organization** and authorize the app
  </Step>

  <Step title="Get Credentials">
    1. Go to **Basic Information** in the app settings
    2. Copy the **Client ID** and **Client Secret**
  </Step>

  <Step title="Add Server in Runlayer">
    1. In Runlayer, go to **My connectors**, find **Slack** (not **Slack (Deploy)**), and click **Add connector**
    2. Choose **Use my own Slack app** and enter your **Client ID** and **Client Secret** from the **Basic Information** tab on your Slack app
    3. Click **Create**
  </Step>

  <Step title="Authorize">
    1. Click **Connect** on the server page
    2. Select your workspace(s) and click **Allow**
  </Step>
</Steps>

## Troubleshooting

<Accordion title="MCP access not enabled">
  Slack's MCP server was GA'd on February 17, 2026. Slack may require you to request access from Slack before the OAuth flow will work. Check [Slack's MCP documentation](https://docs.slack.dev/ai/slack-mcp-server/) for the latest access requirements.
</Accordion>

<Accordion title="Redirect URI mismatch (bring-your-own-app)">
  If you're using your own Slack app, verify the redirect URL matches exactly: `https://<your-tenant>.runlayer.com/oauth/callback` (no trailing slash).
</Accordion>

<Accordion title="Missing scopes error">
  Ensure all scopes from the manifest are added to your Slack app. The official MCP server requires specific scopes that differ from the standard Slack API scopes.
</Accordion>