Skip to main content
Runlayer Deploy Required: This server requires Runlayer Deploy to be enabled.
Connect your AI assistant to Slack for messaging, channel management, and workspace search. Uses Slack OAuth for authentication.

​
Available Tools

ToolDescription
searchSearch messages across channels with Slack search modifiers
list_channelsList all channels in the workspace
get_channelGet details about a specific channel
get_channel_historyGet recent messages from a channel
get_conversation_membersList members in a channel or conversation
send_messageSend messages to channels or DMs with Block Kit support
fetchFetch a specific message by channel and timestamp
list_usersList all users in the workspace
get_profileGet user profile information
get_thread_messagesGet all messages in a thread
get_reactionsGet emoji reactions on a message
add_reactionAdd an emoji reaction to a message
list_usergroupsList all user groups
get_usergroup_membersGet members of a user group
get_team_infoGet workspace/team information

​
Setup

1

Create Slack App from Manifest

  1. Go to Slack API: Applications
  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):
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
  1. Click Next, review the summary, then click Create
2

Install App to Workspace

  1. Go to Settings > Install App in the sidebar
  2. Click Install to Workspace and authorize the app
3

Get Credentials

  1. Go to Basic Information in the app settings
  2. Copy the Client ID and Client Secret
4

Add Server in Runlayer

  1. In Runlayer, go to Catalog > Slack > Install MCP
  2. Check Custom OAuth credentials
  3. Enter your Client ID and Client Secret
  4. Click Deploy Server
5

Authorize

  1. Click Connect on the server page
  2. Select your workspace and click Allow

​
Troubleshooting

Verify the redirect URL matches exactly: https://<your-tenant>.runlayer.com/oauth/callback/ (include trailing slash).
Add the missing scope in Slack’s OAuth & Permissions, then revoke and reconnect in Runlayer.