telegram-mcp
View on GitHubTelegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.
Telegram MCP server built on Telethon that exposes 80+ tools so MCP clients like Claude and Cursor can read chats, send and edit messages, manage groups, contacts, media and folders, and transcribe voice notes.
Use Cases
Send, edit, schedule and delete Telegram messages from an MCP clientRead and search chat history and message contextCreate and administer groups, channels, admins and bansManage contacts including aliases and saved namesTranscribe voice messages and video notes to textSend and download media, stickers, GIFs and albumsWait for or subscribe to incoming message eventsManage folders, drafts, polls, reactions and profile settings
Built With
- Language
- Python
- Frameworks
- Model Context Protocol (MCP) · MCP Python SDK · Telethon · FastMCP · Pytest · Docker · Poetry
Tags
telegram · telethon · mcp-server · messaging · chat-management · groups · contacts · media · voice-transcription · search · claude · cursor · automation · aliases · docker · python