Awesome MCP › Social & Messaging

chigwell/telegram-mcp

⭐ 1606 Python added to this list on 2025-05-06 repository created 2025-03-20

Telegram MCP Server is a comprehensive integration that enables programmatic interaction with Telegram accounts through the Model Context Protocol (MCP). It provides a wide array of tools for managing messaging, chats, groups, contacts, user profiles, media, and more, all accessible via MCP-compatible clients such as Claude and Cursor. The project leverages the Telethon library to interface with Telegram's API, exposing nearly every major Telegram feature as an MCP tool. Key functionalities include chat and group management capabilities like listing chats, creating groups and channels, editing chat titles, managing participants and admins, banning and unbanning users, and handling chat invitations. Messaging features allow for sending, replying, editing, deleting, forwarding, pinning, and unpinning messages, as well as retrieving message context and chat history. Contact management tools enable listing, searching, adding, deleting, blocking, and unblocking contacts, along with bulk import/export options. User and profile management functions provide access to user information, profile updates, and user status checks. Media-related tools offer insights into media content within messages. The server also supports search and discovery of public chats, messages, and usernames, along with sticker sets and bot information management. Privacy and notification settings can be retrieved and modified, and chat muting, archiving, and recent admin actions are also supported. The project excludes certain functionalities that require direct file path access or have reliability issues, such as sending files, voice messages, stickers, and GIFs, due to MCP environment limitations and Telethon/Telegram API constraints. Installation involves cloning the repository, setting up a Python virtual environment, installing dependencies, generating a Telegram session string, and configuring environment variables with Telegram API credentials. The server can be run directly or within a Docker container for easier deployment. Overall, Telegram MCP Server offers a powerful and flexible MCP-based interface to automate and manage Telegram accounts programmatically, making it a valuable tool for developers and users seeking advanced Telegram integrations via the Model Context Protocol.

https://github.com/chigwell/telegram-mcp

ai-integrationautomationbot-commandsbotschat-managementcontact-managementdockergroup-managementmcpmediamedia-infomessagingmodel-context-protocolnotificationsprivacy-settingspythonsearchstickerstelegramtelethonuser-profile