Markitdown

community

content

Convert files to Markdown

<div align="center"> <picture> <img src="https://raw.githubusercontent.com/klavis-ai/klavis/main/static/klavis-ai.png" width="80"> </picture> </div> <h1 align="center">Open Source, easy to use MCPs on Slack, Discord and Web 🚀</h1>

📚 TL;DR

Klavis AI is building open source, easy to use MCPs on Slack, Discord and Web. We provide:

💬 Slack & Discord & Web Clients: Run MCPs directly from your favorite messaging platforms
☁️ Hosted MCP Servers: Access powerful tools without infrastructure management
🎛️ Simple Web UI: Configure and manage everything with no coding required

Whether you're a non-technical user wanting to leverage AI workflows or a developer looking to build and scale MCPs, Klavis makes it simple.

🎬 Watch Our Demo

See how easy it is to use MCPs (like our Report Generator, YouTube tools, and Document Converters) directly from Slack/Discord:

You can find more case study videos on our website.

🚀 Quick Start

For detailed MCP client setup instructions, please refer to the platform-specific documentation:

Discord Bot Setup Guide - Complete instructions for setting up and running the Discord bot
Slack Bot Setup Guide - Step-by-step guide for creating a Slack app and connecting it

For detailed MCP server setup instructions, please refer to the README file under each server folder.

Discord: For Discord API integration
Document Conversion (Pandoc): Convert between various file formats using Pandoc
Firecrawl: For web crawling and data collection
Firecrawl Deep Research: For deeper web research tasks
GitHub: Perform GitHub repository operations
Markitdown: Markdown conversion tool
Postgres: For PostgreSQL database operations
Report Generation: Create professional web reports from user query
Resend: For email services
Slack: For Slack API integration
Supabase: For database operations
YouTube: Extract and convert YouTube video information

🏗️ Architecture

Klavis consists of two main components:

MCP Servers

Located in the

mcp_servers/

directory, these service-specific modules expose capabilities as tools:

Report Generation: Create professional reports from various data sources
YouTube: Download, analyze, and transform YouTube content
Document Conversion: Convert between various file formats using Pandoc
GitHub: Perform GitHub repository operations
Slack: For Slack API integration
Supabase: For database operations
Firecrawl: For web crawling and data collection
Resend: For email services
Postgres: For PostgreSQL database operations
Discord: For Discord API integration

MCP Clients

Located in the

mcp-clients/

directory, these client applications connect to MCP servers and interface with end-user platforms:

Discord Bot: Interactive AI assistant for Discord
Slack Bot: Interactive AI assistant for Slack
Base Client: Shared functionality for all platform clients

🧩 Extending Klavis

Adding a New Tool

Create a new directory in
```
mcp_servers/
```
Implement the MCP server interface
Register your tools with appropriate schemas
Connect to your client through the standard SSE protocol

Adding a New Client Platform

Create a new client module in
```
mcp-clients/
```
Extend the
```
base_bot.py
```
functionality
Implement platform-specific message handling
Connect to MCP servers using
```
mcp_client.py
```

🤝 Contributing

We love contributions! Join our Discord community to discuss ideas and get help.

📚 Citation

If you use Klavis in your research or project, please cite:

@software{klavis2025,
  author = {Klavis AI},
  title = {Klavis: Open-Source MCPs on Slack, Discord and Web},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/klavis-ai/klavis}
}

📜 License

Interact with [EduBase](https://www.edubase.net), a comprehensive e-learning platform with advanced quizzing, exam management, and content organization capabilities

View Details