@neuroequalityorg/mcp-slack

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

Installation

``bash
npm install -g @neuroequalityorg/mcp-slack
`

Or use with npx:

`bash
npx @neuroequalityorg/mcp-slack
`

Configuration

Set your Slack Bot Token as an environment variable:

`bash
export SLACK_BOT_TOKEN=xoxb-your-bot-token
`

$3

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):

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

Available Tools

$3

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

$3

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

$3

List all users in the Slack workspace.

Parameters:
- limit (optional): Max results (default: 100)
- cursor (optional): Pagination cursor

$3

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"

$3

Create a new Slack channel.

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

$3

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 - tommy@gain.energy