Telegram MCP server logo

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.

View on GitHub

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?

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?

You can obtain the API ID and hash from the Telegram API website: my.telegram.org/auth

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?

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?

When authorizing the server, add the --password <2fa_password> flag to the telegram-mcp auth command.