mcp-telegram

<div align="center"> <h2 style="margin-top: 0">Enable LLMs to control your Telegram</h2> </div>

<div align="center"> <a href="https://github.com/dryeab/mcp-telegram/stargazers"></a> <a href="https://badge.fury.io/py/mcp-telegram"></a> <a href="https://x.com/dryeab"></a> </div> <h3></h3>

Connect Large Language Models to Telegram via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction).

Built with Telethon, this server allows AI agents to interact with Telegram, enabling features like sending/editing/deleting messages, searching chats, managing drafts, downloading media, and more using the MTProto.

--- <details> <summary><strong>Table&nbsp;of&nbsp;Contents</strong></summary>

• 🚀 Getting Started
• Prerequisites
• Installation
• ⚙️ Usage
• Login
• Connect to the MCP server
• 🧰 Available Tools
• 📨 Messaging Tools
• 🔍 Search & Navigation
• 📝 Draft Management
• 📂 Media Handling
• 🛠️ Troubleshooting
• 🤝 Contributing
• 📝 License

</details>

---

• Python 3.10 or higher
• `uv` Install via the official uv guide.

Install the mcp-telegram CLI tool:

uv tool install mcp-telegram