MCP Server for Slack - Messages, Channels, User management
npm install @plugix/mcp-slackMCP server for Slack workspace integration - messages, channels, and user management.
- list_channels - List channels in the workspace
- get_channel_history - Get message history from a channel
- send_message - Send a message to a channel (with confirmation)
- list_users - List users in the workspace
- get_user_info - Get detailed user information
- search_messages - Search messages across the workspace
- upload_file - Upload a file to a channel (with confirmation)
- create_channel - Create a new channel (with confirmation)
``bash`
npm install @plugix/mcp-slack
Or run directly:
`bash`
npx @plugix/mcp-slack
Set environment variables:
`envPlugix API connection
API_URL=wss://api.plugix.ai
API_TOKEN=plx_live_your_token_here
$3
1. Go to api.slack.com/apps and create a new app
2. Navigate to OAuth & Permissions
3. Add the required Bot Token Scopes (see below)
4. Install the app to your workspace
5. Copy the Bot User OAuth Token (starts with
)Usage
$3
`bash
npm run dev
`$3
bash
npm run build
npm start
`$3
bash
docker build -t plugix-mcp-slack .
docker run --env-file .env plugix-mcp-slack
`$3
Add to
:`json
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["@plugix/mcp-slack"],
"env": {
"API_URL": "wss://api.plugix.ai",
"API_TOKEN": "plx_live_your_token",
"SLACK_BOT_TOKEN": "xoxb-your-bot-token"
}
}
}
}
`Tools Reference
$3
List channels in the Slack workspace.
Parameters:
| Name | Type | Description |
|------|------|-------------|
| exclude_archived | boolean | Exclude archived channels (default: true) |
| limit | number | Maximum channels to return (default: 100) |
| types | string | Channel types: public_channel, private_channel, mpim, im |
Example:
json
{
"name": "list_channels",
"arguments": {
"limit": 50,
"types": "public_channel"
}
}
`$3
Get message history from a channel.
Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| channel_id | string | Yes | Channel ID (e.g., C1234567890) |
| limit | number | No | Max messages to return (default: 50) |
| oldest | string | No | Only messages after this Unix timestamp |
| latest | string | No | Only messages before this Unix timestamp |
Example:
json
{
"name": "get_channel_history",
"arguments": {
"channel_id": "C1234567890",
"limit": 20
}
}
`$3
Send a message to a Slack channel. Requires confirmation.
Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| channel_id | string | Yes | Channel ID to send to |
| text | string | Yes | Message text (supports Slack markdown) |
| thread_ts | string | No | Reply in thread (parent message ts) |
| confirmed | boolean | Yes | Must be
to send |Example:
`json
{
"name": "send_message",
"arguments": {
"channel_id": "C1234567890",
"text": "Hello from the AI assistant!",
"confirmed": true
}
}
`$3
List users in the workspace.
Parameters:
| Name | Type | Description |
|------|------|-------------|
| limit | number | Max users to return (default: 200) |
$3
Get detailed information about a specific user.
Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| user_id | string | Yes | User ID (e.g., U1234567890) |
Example:
json
{
"name": "get_user_info",
"arguments": {
"user_id": "U1234567890"
}
}
`$3
Search messages across the workspace.
Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| query | string | Yes | Search query (supports Slack modifiers) |
| count | number | No | Max results (default: 20) |
| sort_by | string | No | Sort by: score or timestamp |
| sort_dir | string | No | Sort direction: asc or desc |
Search Modifiers:
-
- Messages from a specific user
- in:#channel - Messages in a specific channel
- has:link - Messages with links
- has:emoji - Messages with emoji
- before:2024-01-01 - Messages before a date
- after:2024-01-01 - Messages after a dateExample:
`json
{
"name": "search_messages",
"arguments": {
"query": "from:@john project deadline",
"count": 10,
"sort_by": "timestamp"
}
}
`$3
Upload a file to a Slack channel. Requires confirmation.
Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| channel_id | string | Yes | Channel ID |
| content | string | Yes | File content |
| filename | string | Yes | Filename (e.g., report.txt) |
| title | string | No | File title |
| initial_comment | string | No | Message with the file |
| thread_ts | string | No | Upload to thread |
| confirmed | boolean | Yes | Must be
to upload |Example:
`json
{
"name": "upload_file",
"arguments": {
"channel_id": "C1234567890",
"content": "Report data here...",
"filename": "report.txt",
"title": "Monthly Report",
"initial_comment": "Here's the monthly report",
"confirmed": true
}
}
`$3
Create a new Slack channel. Requires confirmation.
Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| name | string | Yes | Channel name (lowercase, no spaces) |
| is_private | boolean | No | Create as private (default: false) |
| confirmed | boolean | Yes | Must be
to create |Example:
`json
{
"name": "create_channel",
"arguments": {
"name": "project-alpha",
"is_private": false,
"confirmed": true
}
}
`Required Bot Token Scopes
Add these scopes to your Slack app under OAuth & Permissions:
$3
-
- View basic channel information
- channels:history - View messages in public channels
- channels:write - Create and manage public channels$3
-
groups:read - View private channels
- groups:history - View messages in private channels
- groups:write - Create and manage private channels$3
-
im:read - View direct messages
- im:history - View direct message history
- mpim:read - View group direct messages
- mpim:history - View group direct message history$3
-
chat:write - Send messages
- files:write - Upload files$3
-
users:read - View users
- users:read.email - View user email addresses$3
-
search:read - Search messagesTesting
`bash
npm test
``MIT