Slack MCP Server

🚀 Slack MCP (Model Context Protocol) Server

This is a Slack server implementing the Slack MCP protocol, providing various Slack API functions through standardized interfaces. It allows AI models to interact with Slack via a unified interface.

🚀 Quick Start

The Slack MCP Server enables seamless interaction between AI models and Slack. Below are the steps to get it up and running.

✨ Features

• List public channels
• Post messages
• Reply to threads
• Add emoji reactions
• Get channel history
• Get thread replies
• List users
• Get user profiles

📦 Installation

Prerequisites

• Node.js (v16 or higher)
• npm or yarn
• A Slack workspace with admin access
• A Slack bot token
• Your Slack team ID

Steps

1. Clone this repository.
2. Install dependencies:

npm install
# or
yarn install

3. Build the TypeScript code:

npm run build
# or
yarn build

📚 Documentation

Configuration

1. Open index.ts and replace the placeholder values:

public static readonly BOT_TOKEN = "Enter your bot token";
public static readonly TEAM_ID = "Enter your team ID";

Replace these values with your actual Slack bot token and team ID.

Usage

Run the Server

After building the project, you can run the server:

node dist/index.js

Set up in Cursor

To use this MCP server in Cursor:

1. Open Cursor settings.
2. Navigate to the "Model Context Protocol" section.
3. Add a new tool with the following configuration:
   • Name: slack
   • Command: node /actual/path/to/your/dist/index.js
   • Working Directory: /actual/path/to/your/project Replace /actual/path/to/your with your actual paths.

Available Tools

1. slack_list_channels
   • List public channels in the workspace.
   • Optional parameters: limit, cursor
2. slack_post_message
   • Post a message to a channel.
   • Required parameters: channel_id, text
3. slack_reply_to_thread
   • Reply to a message thread.
   • Required parameters: channel_id, thread_ts, text
4. slack_add_reaction
   • Add an emoji reaction to a message.
   • Required parameters: channel_id, timestamp, reaction
5. slack_get_channel_history
   • Get recent messages in a channel.
   • Required parameters: channel_id
   • Optional parameters: limit
6. slack_get_thread_replies
   • Get all replies in a thread.
   • Required parameters: channel_id, thread_ts
7. slack_get_users
   • List all users in the workspace.
   • Optional parameters: limit, cursor
8. slack_get_user_profile
   • Get detailed profile information of a user.
   • Required parameters: user_id

Development

To modify the server:

1. Change the index.ts file.
2. Rebuild the project:

npm run build
# or
yarn build

Security Considerations

• Never commit your actual Slack bot token or team ID to version control.
• Consider using environment variables in production deployments.
• Ensure your Slack bot has the necessary OAuth scopes to perform the required actions.

Contribution

Welcome to submit issues and pull requests to propose improvements.

📄 License

MIT