MCPInstall
slack_mcp logo

slack_mcp

by sukeshofficial 1 stars sukeshofficial/slack_mcp

SlackMCP is a toolset for Slack that enables manual commands and AI interactions.

READMEmain

🤖 Slack_MCP Server

A smart Slack toolset that supports manual commands and AI-powered interactions via Claude and Agno, acting as a Middleware Command Processor (MCP).


⚙️ Project Overview

This project integrates with Slack in two flexible ways:

  1. 🔧 Manual Tools — Trigger custom logic with predefined Slack commands.
  2. 🤖 AI-powered — Use Claude (via Agno) to process natural language commands.

Ideal for automating workflows, responding intelligently in threads, and enhancing Slack-based productivity.


🗃️ Project Structure

FileDescription
main.pyApp entry point — routes messages to the appropriate handler
slack.pySlack event handling and API communication
slack_manual.pyManual command handlers (e.g., /status, /report)
README.mdYou are here 📘
pyproject.tomlProject dependencies and settings
uv.lockLocked dependency versions
.gitignoreFiles ignored by Git
.python-versionPython version used for virtual environment

🚀 How It Works

🛠 Manual Slack Tools

  • Uses Slack slash commands or message keywords.
  • Routes messages to specific functions inside slack_manual.py.
  • Example:
    /report today
    
    ➝ Generates a manual task report.

🧠 Claude (via Agno) Integration

  • Connects to Claude using Agno as a middleware API.
  • Accepts flexible natural language like:
    "Summarize this channel’s last 5 messages."
    "Create a ClickUp task from this message."
    
  • Claude processes the intent and Slack_MCP executes the right logic.

🔧 Setup

1. Clone the Repo

git clone https://github.com/your-username/slack_mcp.git
cd slack_mcp

2. Install dependencies

pip install -r requirements.txt   # or use `uv` if preferred

🔐 Environment Variables

Set up a .env file with:

# Slack
SLACK_BOT_TOKEN=xoxb-...
SLACK_SIGNING_SECRET=...

# Claude / Agno
AGNO_API_KEY=...
CLAUDE_MODEL_ID=claude-2

# Optional
LOG_LEVEL=info

🧪 Running Locally

python main.py

Or using uvicorn (if using FastAPI):

uvicorn main:app --reload

📎 Useful Commands

CommandDescription
/statusShows current server and AI status
/mcp helpLists available manual and Claude commands
Natural messagesRouted through Claude via Agno

📬 Future Improvements

  • Slack thread-context memory
  • Claude fallback when manual commands fail
  • ClickUp/Jira integration

📝 License

MIT License


Built by SukeshOfficial ⚡

More Communication MCP servers

Similar servers from the same category.

Meeting BaaS

meeting-baas

Automates meeting management across Zoom, Google Meet, and Microsoft Teams with tools for recording, transcribing, searching, and sharing meeting content without manual note-taking.

search

Votars

scarletlabs-ai

Integrates with Votars platform to provide access to meeting transcripts, enabling retrieval and analysis of voice recordings through transcript fetching tools.

Communication

Nylas

nylas-samples

Bridges email, calendar, and contact APIs across multiple providers, enabling dynamic code generation and authentication abstraction for unified communication integrations.

authentication

Slack

modelcontextprotocol

Channel management and messaging capabilities

managementmessaging