Slack MCP Server

A Model Context Protocol (MCP) server for Slack workspace integration. This server allows AI assistants to interact directly with your Slack workspace, providing tools to manage channels, send messages, list users, and upload files.

Built with TypeScript and utilizing the official Slack Web API.

---

Available Modules & Tools

Channels

Manage workspace channels and memberships.

• channels_create: Creates a new Slack channel (supports public and private).
• channels_list: Lists channels in the workspace. Archived channels are excluded by default.
• channels_invite: Invites one or more workspace members to a channel.

Messages

Send communications to channels or threads.

• messages_send: Sends a message to a Slack channel. Optionally posts as a threaded reply by providing thread_ts.

Users

Retrieve workspace member information.

• users_list: Lists members of the workspace.

Files

Share files from the local filesystem to Slack.

• files_upload: Uploads a file from the server filesystem to a Slack channel. Optionally overrides the display filename and adds an initial comment.

---

Setup & Installation

1. Clone the repository:

   git clone https://github.com/Themetralla3000/slack-mcp-server.git
   cd slack-mcp-server
   

2. Install dependencies:

   npm install
   

3. Create an environment file (.env):

   echo "SLACK_BOT_TOKEN=xoxb-your-bot-token" > .env
   

4. Build the project:

   npm run build
   

Configuration

You must provide a valid Slack Bot Token (xoxb-...). To get one, you need to create a Slack App in your workspace and assign it the necessary OAuth scopes:

• channels:manage, channels:read, channels:join (for Channels)
• chat:write (for Messages)
• users:read, users:read.email (for Users)
• files:write (for Files)

Usage with Claude Desktop / Cursor

To use this MCP with Claude Desktop or Cursor, add the following configuration to your MCP config file (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "slack": {
      "command": "node",
      "args": ["/absolute/path/to/slack-mcp-server/dist/index.js"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token"
      }
    }
  }
}

License

MIT License