Telegram MCP server
by chaindead
The Telegram MCP server bridges the Telegram API with AI assistants using the Model Context Protocol. It provides a clear and safe way for AI assistants to work with Telegram, allowing users to interact with their messages and chats through AI.
Last updated: N/A
What is Telegram MCP server?
The Telegram MCP server is a bridge that enables AI applications to interact with the Telegram API using the Model Context Protocol (MCP). It allows AI assistants like Claude Desktop or Cursor to access and manipulate Telegram data, providing a controlled and secure interface.
How to use Telegram MCP server?
To use the server, you need to install it using Homebrew, NPX, from releases, or from source. After installation, you must configure the server by obtaining API credentials from Telegram and authorizing the server. Finally, configure your AI assistant (e.g., Claude Desktop, Cursor) to connect to the Telegram MCP server by specifying the command and environment variables in the assistant's configuration file.
Key features of Telegram MCP server
Get current account information
List dialogs with optional unread filter
Mark dialog as read
Retrieve messages from specific dialog
Send draft messages to any dialog
Use cases of Telegram MCP server
Checking for unread important messages in Telegram
Summarizing unread Telegram messages
Analyzing unread messages and preparing draft responses
Categorizing Telegram chats by importance
FAQ from Telegram MCP server
What is MCP?
What is MCP?
The Model Context Protocol (MCP) is a system that lets AI apps connect to external tools and data sources.
How do I get Telegram API credentials?
How do I get Telegram API credentials?
You can obtain the API ID and hash from the Telegram API website: my.telegram.org/auth
How do I install the server?
How do I install the server?
You can install the server using Homebrew, NPX, from releases (MacOS, Linux, Windows), or from source.
How do I configure my AI assistant to use the server?
How do I configure my AI assistant to use the server?
You need to modify the AI assistant's configuration file (e.g., claude_desktop_config.json) to include the Telegram MCP server configuration, specifying the command, arguments, and environment variables.
What if I have 2FA enabled on my Telegram account?
What if I have 2FA enabled on my Telegram account?
When authorizing the server, add the --password <2fa_password>
flag to the telegram-mcp auth
command.