Telegram MCP Server
Telegram API interactions for AI agents to list chats, read messages, and send drafts.
Data last scanned yesterday · Reviewed last month
Overview
The Telegram MCP Server acts as an interface between the Telegram API and AI assistants, enabling automated message management and organization directly within an MCP-compatible environment. Users can interact with their Telegram account to retrieve account information, list dialogs, mark messages as read, and prepare draft messages. Designed for integration with tools like Claude Desktop, this server provides a structured approach for AI to assist with communication tasks, such as summarizing unread messages or organizing conversations into logical categories. The project is implemented in Go and supports installation via Homebrew, NPX, or direct releases.
Our verdict
With a security score of 45/100, this server is classified as high-risk. It is maintained by a small community contributor group rather than the official Telegram vendor, and critical security features such as read-only mode, OAuth support, and authentication methods have not yet been reviewed for safety. Given the potential for account suspension by Telegram for API misuse, this server is intended only for users who are comfortable with these significant security and operational risks.
- Zero direct dependencies reduce the supply-chain attack surface.
- Project repository is actively maintained by two contributors.
- Licensed under the MIT open-source license.
- Security for authentication and read-only modes is unreviewed.
- Community-maintained rather than developed by official Telegram staff.
- No verified homepage link provided in the repository.
Tools
| Tool | Description | Risk |
|---|---|---|
| tg_me | Get current account information | low |
| tg_dialogs | List dialogs with optional unread filter | low |
| tg_read | Mark dialog as read | medium |
| tg_dialog | Retrieve messages from specific dialog | low |
| tg_send | Send draft messages to any dialog | medium |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What prerequisites do I need to run this server?
You need your Telegram API ID and API hash, which are required for authentication and configuration.
›Can I run this server using NPX?
Yes, you can run the latest version using npx directly, which is supported on macOS, Linux, and Windows.
›What are the primary capabilities of this MCP server?
It allows AI assistants to get account info, list and read dialogs, retrieve messages from specific chats, and send draft messages.
›Are there any specific safety warnings regarding Telegram's API?
Yes, you must read the Telegram API Terms of Service, as misuse of the API can result in the suspension of your Telegram account.
Alternatives
Changelog
Badge
Maintain this server? Add the live badge to your README.