@neuroequalityorg/mcp-slack

MCP (Model Context Protocol) server for Slack API integration. Enables AI assistants to interact with Slack workspaces.

Installation

npm install -g @neuroequalityorg/mcp-slack

Or use with npx:

npx @neuroequalityorg/mcp-slack

Configuration

Set your Slack Bot Token as an environment variable:

export SLACK_BOT_TOKEN=xoxb-your-bot-token

Required Slack App Permissions

Your Slack app needs the following OAuth scopes:

• channels:read - List channels
• channels:write - Create channels
• channels:history - Read channel history
• chat:write - Send messages
• groups:read - List private channels
• groups:write - Create private channels
• groups:history - Read private channel history
• im:history - Read direct message history
• mpim:history - Read group DM history
• search:read - Search messages
• users:read - List users
• users:read.email - Read user emails

Usage with Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["@neuroequalityorg/mcp-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token"
      }
    }
  }
}

Available Tools

send_message

Send a message to a Slack channel or user.

Parameters:

• channel (required): Channel ID or name
• text (required): Message text to send
• thread_ts (optional): Thread timestamp to reply in a thread

list_channels

List all channels in the Slack workspace.

Parameters:

• types (optional): Channel types (default: "public_channel,private_channel")
• limit (optional): Max results (default: 100)
• cursor (optional): Pagination cursor

list_users

List all users in the Slack workspace.

Parameters:

• limit (optional): Max results (default: 100)
• cursor (optional): Pagination cursor

search_messages

Search for messages in Slack.

Parameters:

• query (required): Search query (supports Slack search modifiers)
• count (optional): Number of results (default: 20)
• sort (optional): "score" or "timestamp"
• sort_dir (optional): "asc" or "desc"

create_channel

Create a new Slack channel.

Parameters:

• name (required): Channel name (lowercase, no spaces)
• is_private (optional): Create as private channel

get_channel_history

Get message history from a Slack channel.

Parameters:

• channel (required): Channel ID
• limit (optional): Number of messages (default: 50)
• oldest (optional): Messages after this Unix timestamp
• latest (optional): Messages before this Unix timestamp
• cursor (optional): Pagination cursor

License

MIT

Author

NeuralQuantum - [email protected]