Slack MCP Server

Slack MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with Slack workspaces. This server provides tools for reading messages, posting messages, managing channels, and more through the Slack API.

Features

• Channel Management: List channels, get channel info, create channels
• Message Operations: Send messages, read message history, reply to threads
• User Management: Get user information, list workspace members
• File Operations: Upload files, share files in channels
• Search: Search messages and files across the workspace
• Reactions: Add and remove emoji reactions to messages

Prerequisites

• Python 3.8 or higher
• A Slack workspace with admin permissions
• Slack Bot Token with appropriate scopes

Installation

1. Clone this repository:

2. Install dependencies:

3. Set up your Slack Bot Token (see Configuration section below)

Configuration

Setting up Slack Bot Token

1. Go to Slack API and create a new app
2. Navigate to "OAuth & Permissions" in the sidebar
3. Add the following Bot Token Scopes:
   • channels:read - View basic information about public channels
   • channels:write - Manage public channels
   • chat:write - Send messages as the bot
   • chat:write.public - Send messages to channels the bot isn't a member of
   • files:read - View files shared in channels and conversations
   • files:write - Upload, edit, and delete files
   • groups:read - View basic information about private channels
   • im:read - View basic information about direct messages
   • mpim:read - View basic information about group direct messages
   • reactions:read - View emoji reactions and their associated content
   • reactions:write - Add and edit emoji reactions
   • search:read - Search messages and files
   • users:read - View people in the workspace
   • channels:history - View messages and other content in public channels
   • groups:history - View messages and other content in private channels
   • im:history - View messages and other content in direct messages
   • mpim:history - View messages and other content in group direct messages
4. Install the app to your workspace
5. Copy the "Bot User OAuth Token" (starts with xoxb-)

Environment Variables

Set your Slack Bot Token as an environment variable:

Or create a .env file in the project root:

Usage

Running the Server

The server will start and listen for MCP connections via stdio.

Using with Claude Desktop

Add the following configuration to your Claude Desktop config file:

Available Tools

The server provides the following tools:

Channel Operations

• list_channels() - List all channels in the workspace
• get_channel_info(channel_id) - Get detailed information about a channel
• create_channel(name, is_private=False) - Create a new channel

Message Operations

• send_message(channel, text, thread_ts=None) - Send a message to a channel
• get_channel_history(channel, limit=10) - Get recent messages from a channel
• search_messages(query, count=20) - Search for messages across the workspace

User Operations

• get_user_info(user_id) - Get information about a user
• list_users() - List all users in the workspace

File Operations

• upload_file(channels, content, filename, title=None) - Upload a file to channels
• search_files(query, count=20) - Search for files in the workspace

Reaction Operations

• add_reaction(channel, timestamp, name) - Add an emoji reaction to a message
• remove_reaction(channel, timestamp, name) - Remove an emoji reaction from a message

Examples

Sending a Message

Getting Channel History

Searching Messages

Creating a Channel

Error Handling

The server includes comprehensive error handling for:

• Invalid Slack tokens
• Rate limiting
• Network connectivity issues
• Invalid channel/user IDs
• Permission errors

Security Considerations

• Store your Slack Bot Token securely and never commit it to version control
• Use environment variables or secure secret management
• Regularly rotate your bot tokens
• Monitor bot activity in your Slack workspace
• Grant only the minimum required permissions

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues and questions:

1. Check the Slack API documentation
2. Review the MCP specification
3. Open an issue in this repository