Telegram MCP Server
Telegram messages and dialogs accessed through Model Context Protocol integration.
Data last scanned 2 days ago · Reviewed 2 days ago
Overview
This server acts as a bridge between the Telegram API and AI assistants that support the Model Context Protocol. It allows users to query account details, list active dialogs, and manage message traffic through AI-driven interfaces. The tool includes functionality to list dialogs, filter for unread messages, mark chats as read, and prepare draft messages. Users can leverage these capabilities to summarize communication, categorize chats, or organize conversations based on importance.
Our verdict
With a security score of 40/100, this server carries a high-risk rating. It is a community-maintained project rather than an official Telegram release, and critical aspects such as OAuth support, authentication methods, and read-only mode have not yet been editorially reviewed. Given the potential for account suspension under Telegram’s terms of service, this tool is best suited for advanced users testing in sandbox environments rather than those managing sensitive or primary communication accounts.
- Zero direct dependencies reduce the supply-chain attack surface.
- Documentation provided for installation across multiple operating systems.
- Published under the open-source MIT license.
- Community-maintained with no official vendor support.
- Critical authentication and security mechanisms remain unreviewed.
- Lack of verified read-only mode poses operational risks.
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.