Slack MCP

Slack MCP Server

A Model Context Protocol (MCP) server that provides seamless Slack integration for AI assistants. This server enables AI models to interact with Slack workspaces through a comprehensive set of tools for messaging, channel management, and user interactions.

🚀 Features

Core Slack Tools

Message Management: Send messages to channels and users
Channel Operations: List channels and retrieve message history
User Management: Get workspace user information
Message Search: Search across workspace messages
Custom Tools: Specialized tools for specific workflows

Special Features

Smart Workday Calculation: Automatically reads messages from the previous workday
User-Specific Filtering: Dedicated tool for reading specific user messages
Rich Message Information: Includes user details, timestamps, and thread information
Flexible Time Ranges: Support for custom date ranges and all-time searches

📋 Available Tools

Tool Name	Description
`slack_send_message`	Send messages to channels or users
`slack_get_channels`	Get list of workspace channels
`slack_get_users`	Get list of workspace users
`slack_get_channel_history`	Retrieve channel message history
`slack_search_messages`	Search messages across workspace
`read_frontend_ladisai_messages`	Special: Read Neil Kuo's messages from frontend-ladisai channel

🛠️ Installation

Prerequisites

Node.js 18 or higher
npm or yarn
Slack Bot Token with appropriate permissions

Setup

Clone and install dependencies:
git clone <repository-url> cd slack-mcp npm install
Build the project:
npm run build

⚙️ Configuration

Environment Variables

Create a .env file with the following:

# Required: Slack Bot Token from https://api.slack.com/apps

Slack Bot Permissions

Your Slack Bot needs the following OAuth scopes:

Required Scopes

channels:read - Read public channels
channels:history - Read channel message history
groups:read - Read private channels
groups:history - Read private channel history
users:read - Read user information
chat:write - Send messages
search:read - Search messages

Optional Scopes

channels:manage - Create channels (if using channel creation tools)
groups:write - Manage private channels

MCP Configuration

Add to your MCP client configuration (e.g., Cursor's mcp.json):

{
  "mcpServers": {
    "slack-mcp": {
      "command": "node",
      "args": [
        "YOUR_PATH/slack-mcp/dist/index.js",
        "--token",
        "YOUR TOKEN",
        "--user-id",
        "YOUR PERSONAL SLACK ID"
      ]
    }
  }
}

🎯 Usage Examples

Basic Message Sending

// Send a message to a channel
{
  "tool": "slack_send_message",
  "parameters": {
    "channel": "general",
    "text": "Hello from MCP!"
  }
}

// Send a direct message to a user
{
  "tool": "slack_send_message",
  "parameters": {
    "channel": "U1234567890",
    "text": "Private message"
  }
}

Reading Channel History

// Get recent messages from a channel
{
  "tool": "slack_get_channel_history",
  "parameters": {
    "channel": "frontend-ladisai",
    "limit": 10
  }
}

Special: Reading Neil Kuo's Messages

// Get Neil Kuo's latest messages (automatic workday detection)
{
  "tool": "read_frontend_ladisai_messages",
  "parameters": {
    "max_results": 5
  }
}

// Get all-time latest messages
{
  "tool": "read_frontend_ladisai_messages",
  "parameters": {
    "all_time": true,
    "max_results": 10
  }
}

// Get messages from a specific date
{
  "tool": "read_frontend_ladisai_messages",
  "parameters": {
    "manual_date": "2025-01-27",
    "max_results": 5
  }
}

User and Channel Information

// List all users
{
  "tool": "slack_get_users",
  "parameters": {
    "limit": 100
  }
}

// List all channels
{
  "tool": "slack_get_channels",
  "parameters": {
    "exclude_archived": true
  }
}

🔧 Development

Scripts

npm run build - Build the TypeScript project
npm run dev - Build and watch for changes
npm start - Start the MCP server
npm run typecheck - Run TypeScript type checking

Project Structure

slack-mcp/
├── src/
│   ├── index.ts              # Main MCP server
│   ├── slack-client.ts       # Slack API client wrapper
│   └── tools/
│       ├── index.ts          # Tool registry
│       ├── send-message.ts   # Message sending tool
│       ├── get-channels.ts   # Channel listing tool
│       ├── get-users.ts      # User listing tool
│       ├── get-channel-history.ts  # Channel history tool
│       ├── search-messages.ts      # Message search tool
│       └── read-frontend-ladisai.ts # Custom Neil Kuo reader
├── dist/                     # Compiled JavaScript
├── package.json
└── README.md

🔍 Smart Workday Logic

The read_frontend_ladisai_messages tool includes intelligent workday calculation:

Monday → Reads Friday's messages (3 days back)
Tuesday → Reads Monday's messages (1 day back)
Wednesday → Reads Tuesday's messages (1 day back)
Thursday → Reads Wednesday's messages (1 day back)
Friday → Reads Thursday's messages (1 day back)
Saturday → Reads Friday's messages (1 day back)
Sunday → Reads Friday's messages (2 days back)

🐛 Troubleshooting

Common Issues

"Failed to get channel list"
- Check if your bot has channels:read permission
- Ensure the bot is added to the workspace
"Failed to get channel history"
- Verify the bot has channels:history permission
- Check if the bot is invited to the specific channel
"Message sent successfully" but no message appears
- Confirm the bot has chat:write permission
- Verify the channel name/ID is correct
MCP server not responding
- Check if the build was successful: npm run build
- Verify environment variables are set correctly
- Restart your MCP client (e.g., Cursor)

Testing the Server

# Test if the server responds to tool list requests
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | node dist/index.js

📝 License

MIT License - see LICENSE file for details.

🤝 Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request

📞 Support

For issues and questions:

Check the troubleshooting section above
Review Slack API documentation
Check MCP protocol specifications

Note: This MCP server is optimized for the frontend-ladisai channel workflow and includes specialized tools for reading Neil Kuo's messages with smart workday detection.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A simple Model Context Protocol server for Slack integration that enables messaging, channel management, and workspace search capabilities.

Related MCP Servers

MCP Server for Slack
z9905080
-
security
A
license
-
quality
A Model Context Protocol server implementation that enables AI assistants to interact with Slack workspaces, allowing them to browse channels, send messages, reply to threads, add reactions, and retrieve user information.
Last updated -
16
1
JavaScript
Apache 2.0
Slack MCP Server
ubie-oss
A
security
A
license
A
quality
A server implementing Model Context Protocol that enables AI assistants to interact with Slack API through a standardized interface, providing tools for messaging, channel management, user information retrieval, and more.
Last updated -
9
53
JavaScript
Apache 2.0
Slack MCP Server
MNizarSall
-
security
A
license
-
quality
Enables AI assistants to interact with Slack workspaces through the Model Context Protocol, providing tools for reading/sending messages, managing channels, and accessing Slack API functionality.
Last updated -
Python
MIT License
Slack MCP Server
hyunol7
-
security
F
license
-
quality
A Model Context Protocol server that integrates with Slack API, allowing users to send messages, view channel history, manage channels, send direct messages, and retrieve user lists from Slack workspaces.
Last updated -
Python

View all related MCP servers

Slack MCP

Slack MCP Server

🚀 Features

Core Slack Tools

Special Features

📋 Available Tools

🛠️ Installation

Prerequisites

Setup

⚙️ Configuration

Environment Variables

Slack Bot Permissions

Required Scopes

Optional Scopes

MCP Configuration

🎯 Usage Examples

Basic Message Sending

Reading Channel History

Special: Reading Neil Kuo's Messages

User and Channel Information

🔧 Development

Scripts

Project Structure

🔍 Smart Workday Logic

🐛 Troubleshooting

Common Issues

Testing the Server

📝 License

🤝 Contributing

📞 Support

Related MCP Servers

MCP Server for Slack

Slack MCP Server

Slack MCP Server

Slack MCP Server

New MCP Servers

MCP directory API