Skip to main content
Glama

mcp_slack

Slack-MCP

This project is a Multi-Tool MCP (Model Context Protocol) server for Slack automation using the FastMCP library. It allows you to fetch and process Slack messages using AI agents.This project is great example to learn and Build Understanding reagarding MCPs.


📂 Folder Structure

slack-mcp/ ├── main.py # Main MCP tool server with multiple tools ├── .env # Store your SLACK_TOKEN safely here ├── smithery.yaml # Configuration for Smithery deployment ├── README.md # This file ├── uv-lock └── pyproject.toml # Python dependencies

🚀 Tools in This MCP

1. get_recent_messages

Fetches the most recent messages from a given Slack channel.

  • Inputs: channel_id, limit
  • Returns: Formatted recent messages.

2. get_user_messages

Fetches messages from a specific user within a channel.

  • Inputs: channel_id, username, limit
  • Returns: Messages sent by the user.

3. summarize_recent_messages

Summarizes the last N messages from a channel using a connected LLM.

  • Inputs: channel_id, limit
  • Returns: AI-generated summary.

4. group_messages_by_user

Groups recent channel messages by sender.

  • Inputs: channel_id, limit
  • Returns: A grouped format like:
    @user1: - Message 1 - Message 2 @user2: - Message A

🚪 Slack OAuth Setup & Token Generation

1. Create a Slack App

2. Set OAuth Scopes

In OAuth & Permissions, under Bot Token Scopes, add:

  • channels:read
  • channels:history
  • users:read
  • chat:write (optional for sending messages)

3. Install to Workspace

  • Click Install App to Workspace
  • Authorize permissions
  • Copy the Bot User OAuth Token (starts with xoxb-...)

4. Save the Token

Create a .env file:

SLACK_TOKEN=xoxb-your-token-here

If you change scopes later:

  • Revisit OAuth & Permissions
  • Click Reinstall App to apply new scopes

✨ Testing the Tools

On MCP Inspector (Local)

  1. Run the server:
python main.py
  1. Use MCP Inspector to call tools and test output
mcp dev main.py

On Smithery (Cloud)

  1. Push your code to GitHub
  2. Deploy your MCP to Smithery
  3. Use the "Run tool" tab to test individual tools

On Claude (Cloud Desktop)

You can connect these tools via Smithery to Claude workflows for real-time Slack insights and summaries.


🚜 Requirements

Install dependencies with:

uv pip install -r pyproject.toml

Or manually:

pip install fastmcp httpx python-dotenv

🔧 Environment File (.env)

SLACK_TOKEN=xoxb-123-your-token

🎉 Contributing

Pull requests are welcome. If you’d like to add new Slack tools (e.g., send_message, track_reactions, etc.), feel free to open an issue or PR.


📹 Video Demo On claude desktop:

https://github.com/user-attachments/assets/37d905a5-6382-40ce-9500-2dd744656546


🙏 Acknowledgments


📊 Example Output

Grouped Slack Messages:

@bakar: - Just pushed latest PR - Working on the backend API @hamza: - Updated Figma designs - Fixed navbar bug

📊 Smithery.ai (Cloud Deployment)

Here is the URL go and checkout this mcp_server: Slack_MCP_Server


🧑‍💻 Author

Built by Abu Bakar Yasir — Computer Engineering @ COMSATS + AI Software Engineer | Full Stack Developer 🚀

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

fetch the latest channels messages chat

Related MCP Servers

  • -
    security
    A
    license
    -
    quality
    Facilitates semantic analysis of chat conversations through vector embeddings and knowledge graphs, offering tools for semantic search, concept extraction, and conversation pattern analysis.
    Last updated -
    11
    Python
    MIT License
  • A
    security
    F
    license
    A
    quality
    Enables interaction with the Twitch API, allowing users to retrieve comprehensive information about channels, streams, games, and more, with additional support for searching and accessing chat elements like emotes and badges.
    Last updated -
    14
    3
    1
    TypeScript
    • Apple
    • Linux

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Abu-BakarYasir/my_slack_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server