easy-slack-mcp

<img src="images/slack.jpg" alt="Slack Logo" style="width: 100%;"/>

<h2 style="font-size: 1.5em; margin: 1em 0;">🚀 The Easiest way to run Slack MCP</h2>

Slack integration for AI assistants - Connect Cursor, Claude Desktop, and other MCP-compatible tools directly to Slack. Send messages, read channels, manage users, and automate workflows with AI.

📦 What We Provide

🚀 Quick Start

SLACK_BOT_TOKEN=xoxb-your-token-here npx easy-slack-mcp

That's it! The server runs on:

📋 Detailed Configuration

Getting Your Slack Bot Token

1. Go to https://api.slack.com/apps
2. Click "Create New App" → "From scratch"
3. Give your app a name and select your workspace
4. Click "Create App"
5. Navigate to "OAuth & Permissions" in the sidebar
6. Scroll down to "Bot Token Scopes" and add the following scopes:

• chat:write - Send messages
• chat:write.public - Send to channels bot isn't in
• channels:read - View channel info
• channels:history - Read channel messages
• users:read - View users
• users:read.email - View email addresses
• files:write - Upload files
• files:read - View files
• reactions:write - Add reactions
• reactions:read - View reactions

1. Scroll to the top and click "Install to Workspace"
2. Authorize the app
3. Copy your Bot User OAuth Token (starts with xoxb-)

Using Environment Variables

Instead of passing the token inline, you can use a .env file for persistent configuration:

# Create .env file
echo "SLACK_BOT_TOKEN=xoxb-your-token-here" > .env

# Run (it will automatically load .env)
npx easy-slack-mcp

Local Installation

For a permanent local installation:

# Install locally
npm install easy-slack-mcp

# Create .env file
echo "SLACK_BOT_TOKEN=xoxb-your-token-here" > .env

# Run
npm start
# OR
npx easy-slack-mcp

💻 Use in Cursor / Claude Desktop

Option A: Use as npm package (Recommended)

For Cursor:

1. Open Cursor Settings → Features → Model Context Protocol
2. Click "Edit Config"
3. Add this to your MCP config:

{
  "mcpServers": {
    "easy-slack-mcp": {
      "command": "npx",
      "args": ["-y", "easy-slack-mcp"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token-here"
      }
    }
  }
}

For Claude Desktop:

1. Open ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)

or %APPDATA%\Claude\claude_desktop_config.json (Windows)

1. Add the same configuration above

For any MCP client: The server runs automatically when invoked via npx easy-slack-mcp

#### Client configuration paths

Option B: Local Installation

If you prefer a local setup:

# Install locally
npm install easy-slack-mcp

# Create .env file
echo "SLACK_BOT_TOKEN=xoxb-your-token-here" > .env

# Run it
npx easy-slack-mcp

Then configure your MCP client to run:

npx easy-slack-mcp

📡 Using the REST API

Once the server is running, you have full access to Slack via REST endpoints.

🔍 Interactive API Documentation

📝 Common API Examples

#### Send a Message

curl -X POST http://localhost:8887/slack/messages \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "text": "Hello from easy-slack-mcp!"
  }'

#### List Channels

curl "http://localhost:8887/slack/conversations/list?types=public_channel"

#### Get Channel History

curl "http://localhost:8887/slack/conversations/history?channel=C1234567890&limit=20"

#### List Users

curl "http://localhost:8887/slack/users/list"

#### Upload a File

curl -X POST http://localhost:8887/slack/files/upload \
  -H "Content-Type: application/json" \
  -d '{
    "channels": "C1234567890",
    "filename": "report.txt",
    "content": "File content here"
  }'

📚 All Available Endpoints

⚙️ Advanced Configuration

Environment Variables

All configuration can be set via environment variables:

Example .env content:

SLACK_BOT_TOKEN=xoxb-your-token-here
# Optional
SLACK_APP_TOKEN=xapp-your-app-token
SLACK_SIGNING_SECRET=your-signing-secret
EASY_MCP_SERVER_PORT=8887
EASY_MCP_SERVER_MCP_PORT=8888

Required Slack Scopes

See the Detailed Configuration section above for setup steps. The bot typically needs these scopes:

🎯 Use Cases

In Cursor / Claude Desktop

• "Send a message to #general about the project update"
• "What's the latest activity in #support channel?"
• "Find user @john and show their profile"
• "Summarize this week's messages in #engineering"

Via REST API

• Build custom integrations
• Automate Slack workflows
• Create Slack bots
• Integrate with other services

Via Swagger UI

• Explore endpoints visually
• Test API calls
• Understand request/response formats
• Share API documentation

📖 Learn More

• Easy MCP Server Framework:
• GitHub Repository
• npm Package
• Full Setup Guide: See mcp/resources/slack-quick-start.md
• Complete API Docs: See mcp/resources/api-documentation.md
• Slack API: https://api.slack.com/methods
• Model Context Protocol: https://modelcontextprotocol.io/

📦 Package Info

🆘 Need Help?

1. Check Swagger UI: http://localhost:8887/docs
2. Test authentication: curl http://localhost:8887/slack/auth/test
3. Check server health: curl http://localhost:8887/health
4. Review the setup guide
5. For customization or support, contact [email protected]

Ready to automate Slack with AI? Get started:

# Install and run directly
npx easy-slack-mcp

# Or install locally for project use
npm install easy-slack-mcp
npm start

Powered by [easy-mcp-server](https://github.com/easynet-world/7134-easy-mcp-server) framework