> ## 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

> MCP server for Slack integration

<Warning>
  **No longer maintained.** This Runlayer-built connector is deprecated and
  will not receive further updates. Use [Slack (Official)](/servers/slack-official), Slack's official hosted MCP server, instead.
</Warning>

Connect your AI assistant to [Slack](https://slack.com) for messaging, channel management, and workspace search. Uses **Slack OAuth** for authentication.

## Available Tools

| Tool                       | Description                                                 |
| -------------------------- | ----------------------------------------------------------- |
| `search`                   | Search messages across channels with Slack search modifiers |
| `list_channels`            | List all channels in the workspace                          |
| `get_channel`              | Get details about a specific channel                        |
| `get_channel_history`      | Get recent messages from a channel                          |
| `get_conversation_members` | List members in a channel or conversation                   |
| `send_message`             | Send messages to channels or DMs with Block Kit support     |
| `fetch`                    | Fetch a specific message by channel and timestamp           |
| `list_users`               | List all users in the workspace                             |
| `get_profile`              | Get user profile information                                |
| `get_thread_messages`      | Get all messages in a thread                                |
| `get_reactions`            | Get emoji reactions on a message                            |
| `add_reaction`             | Add an emoji reaction to a message                          |
| `list_usergroups`          | List all user groups                                        |
| `get_usergroup_members`    | Get members of a user group                                 |
| `get_team_info`            | Get workspace/team information                              |

## 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: Slack MCP
      description: MCPs by Runlayer
      background_color: "#2c2d30"
    oauth_config:
      redirect_urls:
        - https://<your-tenant>.runlayer.com/oauth/callback/
      scopes:
        user:
          - channels:history
          - channels:read
          - users:read
          - users:read.email
          - search:read
          - team:read
          - usergroups:read
          - reactions:read
          - reactions:write
          - chat:write
          - groups:read
          - groups:history
          - im:history
          - im:read
          - mpim:read
          - mpim:history
    settings:
      org_deploy_enabled: false
      socket_mode_enabled: false
      token_rotation_enabled: false
    ```

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

  <Step title="Install App to Workspace">
    1. Go to **Settings** > **Install App** in the sidebar
    2. Click **Install to Workspace** 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**, and click **Add connector**
    2. Check **Custom OAuth credentials**
    3. Enter your **Client ID** and **Client Secret**
    4. Click **Deploy Server**
  </Step>

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

## Troubleshooting

<Accordion title="Redirect URI mismatch">
  Verify the redirect URL matches exactly: `https://<your-tenant>.runlayer.com/oauth/callback/` (include trailing slash).
</Accordion>

<Accordion title="Missing scopes error">
  Add the missing scope in Slack's OAuth & Permissions, then revoke and reconnect in Runlayer.
</Accordion>