Connect AI agents to the Slack MCP server

Vendor MCP

The Slack MCP connector routes your AI agent's tool calls to Slack's own MCP server through Scalekit. Each user signs in to Slack once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 19 tools.

Tools: 19
What they doRead · write · destructive: 12 · 6 · 112 read6 write1 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

What you can do

Send messages: post to channels, DMs, and threads across your Slack workspace
Read conversations: retrieve channel history, thread replies, and direct messages
Search channels and users: find channels, team members, and public messages by keyword
Manage canvases: create, read, and update Slack Canvas documents
React to messages: add and retrieve emoji reactions on any message
Schedule messages: deliver messages to channels at a specified future time

Setup

npm install @scalekit-sdk/node dotenv

pip install scalekit-sdk-python python-dotenv

Set your credentials
Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Create the Slack MCP connection
In AgentKit > Connections, create a Slack MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for Slack, so you don't need to register an OAuth app. To show your own app on the consent screen, use your own credentials instead.
Use your own OAuth app
Slack serves Model Context Protocol (MCP) traffic only to apps that have its MCP server turned on. Enable MCP access on the Slack app whose client ID and secret you use for the connection, then create the connection in Scalekit.
1. Enable MCP access in your Slack app
  - Go to api.slack.com/apps and open the app whose Client ID and Client Secret you configure on the Slack MCP connection. MCP access applies per app, so enabling it on any other app has no effect on the connection.
  - In the left sidebar, under Features, click Agents & AI Apps. Some workspaces label this item Agents.
  - Turn on Slack Model Context Protocol (MCP) Server.
2. Connect in Scalekit
  
  In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Slack MCP and click Create. Enter the Client ID and Client Secret of the same Slack app, then click Save.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'slackmcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Slack MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'slackmcp_slack_read_user_profile',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "slackmcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Slack MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="slackmcp_slack_read_user_profile",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

slackmcp_slack_get_reactionsRetrieve all emoji reactions on a specific Slack message.Read-only
Slack Get Reactions
Retrieve all emoji reactions on a specific Slack message.
Inputs
channel_idstringrequired
ID of the Slack channel. Get it from slack_search_channels.
message_tsstringrequired
Timestamp of the message. Get it from slack_read_channel or slack_read_thread.
slackmcp_slack_list_channel_membersList members of a Slack channel, group, or group DM with profile details.Read-only
Slack List Channel Members
List members of a Slack channel, group, or group DM with profile details.
Inputs
channel_idstringrequired
ID of the Slack channel. Get it from slack_search_channels.
cursorstring
Pagination cursor from the previous response to fetch the next page.
include_botsboolean
Include bots and apps in the member list (default: false)
include_deletedboolean
Include deleted/deactivated users in the member list (default: false)
limitinteger
Maximum number of results to return per page.
response_formatstring
Level of detail in the response. Accepted values: detailed, concise, ids_only.
slackmcp_slack_read_canvasRetrieve the Markdown content and section ID mapping of a Slack Canvas document.Read-only
Slack Read Canvas
Retrieve the Markdown content and section ID mapping of a Slack Canvas document.
Inputs
canvas_idstringrequired
ID of the Slack canvas document. Get it from slack_search_public.
slackmcp_slack_read_channelRead messages from a Slack channel in reverse chronological order (newest first).Read-only
Slack Read Channel
Read messages from a Slack channel in reverse chronological order (newest first).
Inputs
channel_idstringrequired
ID of the Slack channel. Get it from slack_search_channels.
cursorstring
Pagination cursor from the previous response to fetch the next page.
lateststring
Only return messages before this Unix timestamp (e.g. 1640995200.000000).
limitinteger
Maximum number of results to return per page.
oldeststring
Only return messages after this Unix timestamp (e.g. 1609459200.000000).
response_formatstring
Level of detail in the response. Accepted values: detailed, concise, ids_only.
slackmcp_slack_read_fileRead a Slack file's content by file ID.Read-only
Slack Read File
Read a Slack file's content by file ID. Returns text or base64-encoded content.
Inputs
file_idstringrequired
ID of the Slack file. Get it from slack_search_public.
slackmcp_slack_read_threadRead all messages in a Slack thread — the parent message and its replies.Read-only
Slack Read Thread
Read all messages in a Slack thread — the parent message and its replies.
Inputs
channel_idstringrequired
ID of the Slack channel. Get it from slack_search_channels.
message_tsstringrequired
Timestamp of the message. Get it from slack_read_channel or slack_read_thread.
cursorstring
Pagination cursor from the previous response to fetch the next page.
lateststring
Only return messages before this Unix timestamp (e.g. 1640995200.000000).
limitinteger
Maximum number of results to return per page.
oldeststring
Only return messages after this Unix timestamp (e.g. 1609459200.000000).
response_formatstring
Level of detail in the response. Accepted values: detailed, concise, ids_only.
slackmcp_slack_read_user_profileRetrieve detailed profile information for a Slack user including status and contact info.Read-only
Slack Read User Profile
Retrieve detailed profile information for a Slack user including status and contact info.
Inputs
include_localeboolean
Include user's locale information. Default: false
response_formatstring
Level of detail in the response. Accepted values: detailed, concise, ids_only.
user_idstring
ID of the Slack user. Get it from slack_search_users.
slackmcp_slack_search_channelsSearch for Slack channels by name or description and return channel IDs and metadata.Read-only
Slack Search Channels
Search for Slack channels by name or description and return channel IDs and metadata.
Inputs
querystringrequired
Search query string.
channel_typesstring
Comma-separated channel types to filter. Accepted values: public_channel, private_channel, mpim, im.
cursorstring
Pagination cursor from the previous response to fetch the next page.
include_archivedboolean
Include archived channels in the search results
limitinteger
Maximum number of results to return per page.
response_formatstring
Level of detail in the response. Accepted values: detailed, concise, ids_only.
slackmcp_slack_search_emojisSearch custom emojis available in this Slack workspace by name.Read-only
Slack Search Emojis
Search custom emojis available in this Slack workspace by name.
Inputs
querystringrequired
Search query string.
slackmcp_slack_search_publicSearch messages and files in public Slack channels only.Read-only
Slack Search Public
Search messages and files in public Slack channels only.
Inputs
querystringrequired
Search query string.
afterstring
Only messages after this Unix timestamp (inclusive)
beforestring
Only messages before this Unix timestamp (inclusive)
content_typesstring
Comma-separated content types to search. Accepted values: messages, files.
context_channel_idstring
Channel ID to boost relevance of results from that channel.
cursorstring
Pagination cursor from the previous response to fetch the next page.
include_botsboolean
Include bot messages (default: false)
include_contextboolean
Include surrounding context messages for each result. Defaults to true.
limitinteger
Maximum number of results to return per page.
max_context_lengthinteger
Max character length for each context message. Longer messages are truncated.
only_my_channelsboolean
Limit results to public channels the user is a member of. Set to true when the user asks to search only their own or joined channels. Default: false.
response_formatstring
Level of detail in the response. Accepted values: detailed, concise, ids_only.
sortstring
Sort by relevance or date (default: 'score'). Options: 'score', 'timestamp'
sort_dirstring
Sort direction (default: 'desc'). Options: 'asc', 'desc'
slackmcp_slack_search_public_and_privateSearch messages and files across all Slack channels including private ones the user has access to.Read-only
Slack Search Public And Private
Search messages and files across all Slack channels including private ones the user has access to.
Inputs
querystringrequired
Search query string.
afterstring
Only messages after this Unix timestamp (inclusive)
beforestring
Only messages before this Unix timestamp (inclusive)
channel_typesstring
Comma-separated channel types to filter. Accepted values: public_channel, private_channel, mpim, im.
content_typesstring
Comma-separated content types to search. Accepted values: messages, files.
context_channel_idstring
Channel ID to boost relevance of results from that channel.
cursorstring
Pagination cursor from the previous response to fetch the next page.
include_botsboolean
Include bot messages (default: false)
include_contextboolean
Include surrounding context messages for each result. Defaults to true.
limitinteger
Maximum number of results to return per page.
max_context_lengthinteger
Max character length for each context message. Longer messages are truncated.
only_my_channelsboolean
Limit results to channels the user is a member of. Set to true when the user asks to search only their own or joined channels. Default: false.
response_formatstring
Level of detail in the response. Accepted values: detailed, concise, ids_only.
sortstring
Sort by relevance or date (default: 'score'). Options: 'score', 'timestamp'
sort_dirstring
Sort direction (default: 'desc'). Options: 'asc', 'desc'
slackmcp_slack_search_usersSearch for Slack users by name, email, or profile attributes.Read-only
Slack Search Users
Search for Slack users by name, email, or profile attributes.
Inputs
querystringrequired
Search query string.
cursorstring
Pagination cursor from the previous response to fetch the next page.
limitinteger
Maximum number of results to return per page.
response_formatstring
Level of detail in the response. Accepted values: detailed, concise, ids_only.
slackmcp_slack_add_reactionAdd an emoji reaction to a Slack message.Write
Slack Add Reaction
Add an emoji reaction to a Slack message. Requires the channel ID, message timestamp, and emoji name.
- Idempotent
Inputs
channel_idstringrequired
ID of the Slack channel. Get it from slack_search_channels.
emojistringrequired
Reaction (emoji) name without colons
message_tsstringrequired
Timestamp of the message. Get it from slack_read_channel or slack_read_thread.
slackmcp_slack_create_canvasCreate a Slack Canvas document from Canvas-flavored Markdown content.Write
Slack Create Canvas
Create a Slack Canvas document from Canvas-flavored Markdown content.
Inputs
contentstringrequired
Canvas-flavored Markdown content for the canvas body.
titlestringrequired
Display name shown at the top of the canvas.
slackmcp_slack_create_conversationCreate a channel, DM, or group DM.Write
Slack Create Conversation
Create a channel, DM, or group DM. Returns a channel ID for sending messages.
Inputs
channel_namestring
Name for the new channel (lowercase, hyphens, max 80 chars). Omit to create a DM instead.
is_privateboolean
If true, creates a private channel. Only used with channel_name. Default: false.
user_idsarray
Slack user IDs to invite. 1 ID = DM, 2–8 IDs = group DM, up to 1000 IDs for a channel.
slackmcp_slack_schedule_messageSchedule a message for future delivery to a Slack channel at a specified Unix timestamp.Write
Slack Schedule Message
Schedule a message for future delivery to a Slack channel at a specified Unix timestamp.
Inputs
channel_idstringrequired
ID of the Slack channel. Get it from slack_search_channels.
messagestringrequired
Message content to schedule
post_atintegerrequired
Unix timestamp (seconds) for when to send the scheduled message.
reply_broadcastboolean
Broadcast thread reply to channel
thread_tsstring
Timestamp of the parent message to reply in a thread. Get it from slack_read_channel.
slackmcp_slack_send_messageSend a message to a Slack channel or user.Write
Slack Send Message
Send a message to a Slack channel or user. Use a user ID as channel_id to send a DM.
Inputs
channel_idstringrequired
ID of the Slack channel. Get it from slack_search_channels.
messagestringrequired
Add a message
draft_idstring
ID of a previously saved draft to delete after sending.
reply_broadcastboolean
Also send to conversation
thread_tsstring
Timestamp of the parent message to reply in a thread. Get it from slack_read_channel.
unfurl_app_linksboolean
Set to true to enable link previews from installed apps (e.g. GitHub, Jira) in the message.
slackmcp_slack_send_message_draftSave a message as a draft in a Slack channel without sending it.Write
Slack Send Message Draft
Save a message as a draft in a Slack channel without sending it.
Inputs
channel_idstringrequired
ID of the Slack channel. Get it from slack_search_channels.
messagestringrequired
The message content in standard markdown
thread_tsstring
Timestamp of the parent message to reply in a thread. Get it from slack_read_channel.
slackmcp_slack_update_canvasUpdate an existing Slack Canvas document by appending, replacing, or deleting content.Destructive
Slack Update Canvas
Update an existing Slack Canvas document by appending, replacing, or deleting content. Prefer `sections` for atomic multi-edit operations; `action`/`content`/`section_id` remain as a legacy single-edit path.
Inputs
canvas_idstringrequired
ID of the canvas to update. Get it from slack_search_public.
actionstring
Legacy single-edit type. Prefer `sections`. One of append, prepend, replace.one of appendprependreplace
contentstring
Legacy single-edit markdown content. Prefer `sections`.
section_idstring
Legacy single-edit target section ID from slack_read_canvas. Prefer `sections`.
sectionsarray
Preferred: array of edit operations applied atomically against a single document snapshot. Max 100 operations. Use this for any update with one or more edits.

Workflows

Proxy API call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENVIRONMENT_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'slackmcp'
12
const identifier = 'user_123'
13

14
// Read a channel's message history
15
const result = await actions.executeTool({
16
  connector,
17
  identifier,
18
  toolName: 'slackmcp_slack_read_channel',
19
  toolInput: { channel_id: 'C01234567' },
20
})
21
console.log(result)

1
from scalekit import ScalekitClient
2
import os
3

4
scalekit_client = ScalekitClient(
5
    os.environ['SCALEKIT_ENVIRONMENT_URL'],
6
    os.environ['SCALEKIT_CLIENT_ID'],
7
    os.environ['SCALEKIT_CLIENT_SECRET'],
8
)
9

10
connector = 'slackmcp'
11
identifier = 'user_123'
12

13
# Read a channel's message history
14
result = scalekit_client.actions.execute_tool(
15
    connection_name=connector,
16
    identifier=identifier,
17
    tool_name='slackmcp_slack_read_channel',
18
    tool_input={'channel_id': 'C01234567'},
19
)
20
print(result)

What you can do

Setup

Install the SDK

Set your credentials

Create the Slack MCP connection

Enable MCP access in your Slack app

Connect in Scalekit

Authorize a user and make your first call

Tools

Call it

Returns

Slack Get Reactions

Inputs

Slack List Channel Members

Inputs

Slack Read Canvas

Inputs

Slack Read Channel

Inputs

Slack Read File

Inputs

Slack Read Thread

Inputs

Slack Read User Profile

Inputs

Slack Search Channels

Inputs

Slack Search Emojis

Inputs

Slack Search Public

Inputs

Slack Search Public And Private

Inputs

Slack Search Users

Inputs

Slack Add Reaction

Inputs

Slack Create Canvas

Inputs

Slack Create Conversation

Inputs

Slack Schedule Message

Inputs

Slack Send Message

Inputs

Slack Send Message Draft

Inputs

Slack Update Canvas

Inputs

Workflows

Proxy API call

Other ways to connect Slack

Related: other Communication connectors