Overview
The Slack integration tool enables users to interact with their Slack workspace directly from chats and agents. This Beta version supports reading and posting messages, managing reactions, and accessing various Slack features until Slack's official MCP becomes generally available (summer 2026).
Learning Objectives:
Configure the Slack integration in your workspace
Set up the integration with standalone clients
Understand available Slack functionality
Learn proper usage for multi-workspace scenarios
Prerequisites
You'll Need:
Access to a workspace
Admin permissions in your Slack workspace
Slack workspace membership
Setting Up the Slack Integration
Connecting Slack in Your Workspace
Navigate to the Tools section in the sidebar
Click on "Tools" in the left navigation panel of your workspace
Locate the "Quick Tools" section
Connect to Slack
Find the "Slack" block in the Quick Tools section
Click the "Connect" button
You will be redirected to Slack's OAuth authorization page
Authorize the Integration
If you belong to multiple workspaces, select your desired workspace from the dropdown menu on the left
Click the "Allow" button to grant necessary permissions
Result: Your workspace is now connected to Slack, allowing you to use Slack features in chats and agents.
Note: This connection authorizes access to your primary Slack workspace. If you're a member of multiple workspaces, you'll need to specify the target workspace when interacting with Slack.
Setting Up in a Standalone Client
Complete TeamAI workspace setup first
Follow all steps in the "Connecting Slack in Your Workspace" section above
Access the tool configuration
Search for the Slack tool in your workspace
Click on "Edit Tool" to open the tool settings
Retrieve your authentication token
In the tool's edit page, click on "Server Setup"
Locate the "x-slack-token" row under Header-based Authentication
Uncheck the "Secret" option
Copy the token value (starting with "xoxp-")
Configure your standalone client
In your client (e.g., Cursor), set up an MCP server with:
Header: "x-slack-token" with your copied token value
Example Configuration for Cursor:
json
{ "mcpServers": { "teamai-slack-mcp": { "url": "https://mcp-slack-596217297778.us-central1.run.app/mcp", "headers": { "x-slack-token": "xoxp-XYZ..." } } } }Result: The Slack integration is now available in your standalone client.
Using the Slack Integration
Working with Multiple Workspaces
Specify the target workspace in your prompts
Always include the workspace name when sending commands
Example: "Post 'Hi there!' to the code-a-yodas channel in the WebpageFX Interactive workspace."
Messaging specific users
When messaging individuals, specify their team/workspace
This helps identify the correct user across multiple workspaces
Important: Failure to specify the target workspace may result in messages being sent to unintended locations or errors in command execution.
Available Features
Messages
Feature | Description |
Get channel messages | Retrieve recent messages from a specific channel |
Get DM messages | Retrieve recent messages from direct conversations |
Post message | Send a message to a channel or direct message conversation |
Reply to message | Respond to a specific message thread |
Get message replies | Retrieve all replies in a message thread |
Search messages | Search across channels and conversations with Slack syntax support |
Channel & User Management
Feature | Description |
Get channels | List public and private channels in workspace |
Get users | List workspace members with basic profile information |
Get user | Get detailed profile for a specific user |
Get team | Get information about the workspace the token is authenticated against |
Content Organization
Feature | Description |
Get/Add bookmarks | View or create bookmarks in channels |
Get/Add pins | View or create pinned messages in channels |
Get/Add reminders | View or create reminders (Note: Slack has deprecated this feature) |
Add reaction | Add emoji reactions to messages |
Important: Reminder functionality has been deprecated by Slack and may not work reliably.
Best Practices
Be specific with workspace names: Always specify the target workspace when working in multi-workspace environments.
Check permissions: Ensure your Slack account has appropriate permissions for the actions you're attempting.
Use search syntax effectively: Leverage Slack's search operators (in:#channel, from:@user, has:link, before/after dates) for precise results.
Common Questions
Q: Can I connect to multiple Slack workspaces simultaneously?
A: Yes, you can interact with any workspace you're a member of, but you must specify the target workspace in your prompts.
Q: Why am I getting authentication errors?
A: Your authentication token may have expired. Try reconnecting the Slack integration in your workspace.
Q: Is message history fully accessible?
A: The integration can only access messages in public channels or conversations you're a part of, within Slack's retention limits.
Q: Will this integration be available long-term?
A: This Beta version will be sunset once Slack's official MCP becomes generally available (anticipated summer 2026).
Q: Can I use Slack apps and integrations through this tool?
A: No, this integration only provides access to core Slack functionality, not third-party Slack apps.