MCP Telegram Server

stdio

An MCP server for interacting with Telegram. It allows searching, sending messages, and managing chats using the Telegram API.

Install

uvx --from

search_messages_globally Search across all chats with multi-term queries, date filtering, and chat type filtering
get_messages Unified message retrieval with search/browse, read by IDs, get replies (posts/topics/messages), 5 modes
send_message Send new message with file attachments (URLs/local), formatting (markdown/html), reply to forum topics
edit_message Edit existing message with text formatting, preserves message structure
find_chats Find users/groups/channels with multi-term search, contact discovery, folder filtering, username/phone lookup
get_chat_info Get detailed profile info including member counts, bio/about, online status, forum topics, enriched data
send_message_to_phone Message phone numbers with auto-contact management, optional cleanup, file support
invoke_mtproto Direct Telegram API access with raw MTProto methods, entity resolution, safety guardrails

★ 44 GitHub stars