slack-mcp-server

What is slack-mcp-server?

slack-mcp-server is a Model Context Protocol (MCP) server that enables AI assistants to interact with the Slack API through a standardized interface. It provides tools for reading and writing messages, managing reactions, and searching workspace content. It is intended for developers who want to integrate Slack capabilities into AI agents or assistants.

How to use slack-mcp-server?

Install the package from GitHub Registry using npm install @ubie-oss/slack-mcp-server (requires a personal access token). Set the required environment variables SLACK_BOT_TOKEN (Slack Bot User OAuth Token) and optionally SLACK_USER_TOKEN (Slack User OAuth Token, needed for search). Run directly with npx @ubie-oss/slack-mcp-server or via node. Configure your MCP client by adding a JSON entry with the command, arguments, and environment variables.

Key features of slack-mcp-server

• List public channels in the workspace with pagination
• Post new messages to Slack channels
• Reply to specific message threads
• Add reaction emojis to messages
• Retrieve recent channel history and thread replies
• Get basic profile information of all users
• Search messages across the workspace

Use cases of slack-mcp-server

• An AI assistant that posts status updates or notifications to Slack channels
• A bot that reads channel history and summarizes recent conversations
• A tool that searches Slack messages for specific keywords or topics
• An integration that replies to threads and adds reactions based on user requests

FAQ from slack-mcp-server

What tokens are required to use slack-mcp-server?

You need a Slack Bot User OAuth Token (SLACK_BOT_TOKEN) and, optionally, a Slack User OAuth Token (SLACK_USER_TOKEN) for features like message search.

How do I install slack-mcp-server?

Install via npm install @ubie-oss/slack-mcp-server. The package is hosted on GitHub Registry, so you must configure a personal access token.

How do I configure slack-mcp-server with my MCP client?

Add an entry to your client’s MCP configuration JSON with "command": "npx", "args": ["-y", "@ubie-oss/slack-mcp-server"], and an "env" object containing the required tokens.

What tools are available in slack-mcp-server?

Nine tools are provided: list channels, post message, reply to thread, add reaction, get channel history, get thread replies, get users, get user profile, and search messages.

How can I run slack-mcp-server in development mode?

Use npm run dev from the project directory to start the server with hot reloading. Run linting with npm run lint and fix issues with npm run fix.