TelegramMCP is an open-source server that connects a personal Telegram account to AI applications supporting the Model Context Protocol (MCP). The tool allows AI assistants to read chat folders, search for conversations, and send text messages using the official TDLib library.
The project runs via Docker and requires users to provide their own Telegram API credentials. Authentication is performed by scanning a QR code, with the session stored locally. The server currently lacks a web interface and operates through standard input/output streams.
The developer notes that the tool is currently in a preview stage (v0.2.0) and has several limitations, including the lack of support for voice message transcription, file attachments, and secret chats. There is no built-in read-only mode, meaning the AI can send messages if authorized.
Future development priorities include improving the server's lifecycle management to prevent multiple container instances from running simultaneously. The project is licensed under MIT and is available on GitHub for testing and experimentation.
