Сервер является мостом между API Telegram и AI-ассистентами и основан на протоколе Model Context Protocol.

[! ВАЖНО] Убедитесь, что вы прочитали и поняли условия использования API Telegram перед использованием этого сервера. Любое неправильное использование API Telegram может привести к блокировке вашего аккаунта.

Содержание

• Что такое MCP?
• Что делает этот сервер?
• Возможности
• Примеры запросов
• Управление сообщениями
• Организация
• Связь
• Установка
• Homebrew
• NPX
• Из релизов
• MacOS
• Linux
• Окна
• Из источника
• Конфигурация
• Авторизация
• Конфигурация клиента
• Версия схемы JSON
• Star History

Что такое MCP?

Протокол контекста модели (MCP) — это система, позволяющая приложениям на базе ИИ, таким как Claude Desktop или Cursor, подключаться к внешним инструментам и источникам данных. Она предоставляет понятный и безопасный способ для помощников ИИ работать с локальными сервисами и API, сохраняя при этом контроль пользователя.

Что делает этот сервер?

Возможности

• [x] Получить информацию о текущем счете (tool: tg_me)
• [x] Список диалогов с опциональным фильтром непрочитанного (tool: tg_dialogs)
• [x] Отметить диалог как прочтение (tool: tg_read)

Telegram MCP server

The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.

[!IMPORTANT] Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account.

Table of Contents

• What is MCP?
• What does this server do?
  • Capabilities
  • Prompt examples
    • Message Management
    • Organization
    • Communication
• Installation
  • Homebrew
  • NPX
  • From Releases
    • MacOS
    • Linux
    • Windows
  • From Source
• Configuration
  • Authorization
  • Client Configuration
  • JSON Schema Version
• Star History

What is MCP?

The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

What does this server do?

Capabilities

• [x] Get current account information (tool: tg_me)
• [x] List dialogs with optional unread filter (tool: tg_dialogs)
• [x] Mark dialog as read (tool: tg_read)
• [x] Retrieve messages from specific dialog (tool: tg_dialog)
• [x] Send draft messages to any dialog (tool: tg_send)

Prompt examples

Here are some example prompts you can use with AI assistants:

Message Management

• “Check for any unread important messages in my Telegram”
• “Summarize all my unread Telegram messages”
• “Read and analyze my unread messages, prepare draft responses where needed”
• “Check non-critical unread messages and give me a brief overview”

Organization

• “Analyze my Telegram dialogs and suggest a folder structure”
• “Help me categorize my Telegram chats by importance”
• “Find all work-related conversations and suggest how to organize them”