Slack MCP Server

The Slack MCP server lets your AI agents interact with a Slack workspace. Agents can read channels, send and edit messages, search conversations, manage reactions, and look up user profiles — all based on the authenticated user's permissions.

Capabilities

Tool	What It Does
Find channel by name	Search for a specific channel by its name
List channels	List available channels in the workspace
Get channel	Retrieve details about a specific channel
Get channel messages	Read recent messages from a channel
Post message	Send a message to a channel
Edit message	Edit an existing message
Delete message	Delete a message
Get thread replies	Read replies within a message thread
Post thread reply	Reply to a message in a thread
List users	List users in the workspace
Get user	Retrieve details about a specific user
Find user by name	Search for a user by their name
Add reaction	Add an emoji reaction to a message
Search messages	Search across conversations in the workspace

OAuth Setup

The Slack MCP server uses OAuth to authenticate on behalf of each user. To enable this integration, you need to create a Slack App and provide the credentials to Devs.ai.

Step 1: Create a Slack App

1. Go to the Slack App Management dashboard and sign in.
2. Click Create New App > From scratch.
3. Enter a name (for example, "Devs AI") and select the workspace where it will be installed.
4. Click Create App.

Step 2: Get Your Credentials

1. On the app settings page, go to Basic Information.
2. Scroll to the App Credentials section.
3. Copy the Client ID and Client Secret (click Show to reveal the secret).

Step 3: Configure the Redirect URL

1. In the left sidebar, go to OAuth & Permissions.
2. Under Redirect URLs, click Add New Redirect URL.
3. Enter the redirect URL provided by your Devs.ai platform administrator.
4. Click Save URLs.

Step 4: Add Required Scopes

1. On the OAuth & Permissions page, scroll to User Token Scopes.
2. Add the following scopes:

Scope	What It Enables
channels:read	View basic info about public channels
channels:history	View messages in public channels
channels:write	Manage public channels and post messages
groups:read	View basic info about private channels
groups:history	View messages in private channels
groups:write	Manage private channels and post messages
chat:write	Send messages as the user
users:read	View people in the workspace
users:read.email	View email addresses
reactions:write	Add and edit emoji reactions
search:read	Search messages and files
im:read	View basic info about direct messages
im:history	View messages in direct messages
im:write	Start direct messages
mpim:read	View basic info about group direct messages
mpim:history	View messages in group direct messages
mpim:write	Start group direct messages

📝 Note: The Slack integration uses user token scopes (not bot scopes) because tools act on behalf of the authenticated user. For example, message search requires a user token since bot tokens cannot access the search.messages API.

Step 5: Configure in Devs.ai

1. Navigate to Organization > Connectors in Devs.ai.
2. Find the Slack template and click Enable.
3. Select OAuth as the authentication type.
4. Enter your Client ID and Client Secret from Step 2.
5. Select the tools you want to make available.
6. Click Save.

When a user first interacts with an agent connected to Slack, they will be prompted to authorize access to their Slack account.

OAuth Configuration Reference

Field	Value
Authorization URL	https://slack.com/oauth/v2/authorize
Token URL	https://slack.com/api/oauth.v2.access
Scopes Parameter Name	user_scope

Additional Resources

• Slack App Management Dashboard
• Slack OAuth 2.0 Documentation
• Slack Scopes Reference