easy-slack-mcp

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

Related MCP server: Slack MCP Server

🚀 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

7. Scroll to the top and click "Install to Workspace"

8. Authorize the app

9. 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)

2. 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 info@easynet.world

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 framework