МессенджерыTelegram

Telegram MCP-сервер и CLI для личного аккаунта

ИИ-агент читает ваш Telegram, говорит, кто ждет ответа, и находит любое сообщение без интернета. Ничего не отмечается прочитанным и не отправляется без вашей просьбы.

Вы видите, кто вас ждет, не листая чаты. tg подключает ваш собственный аккаунт Telegram к ИИ-агенту, которым вы уже пользуетесь, например Claude Code, Codex или Cursor. Он хранит копию чатов на вашем компьютере, поэтому агент ищет по переписке за годы, даже без интернета.

Агент скажет, в каких чатах ждут ответа, что вы обещали на этой неделе и куда Алиса прислала PDF с договором аренды. Он отвечает сообщениями, которые нашел, и готовит черновик ответа, который вы отправляете или правите. Настройка занимает около пяти минут.

На этой странице:

  1. Что вы получите
  2. Что неочевидно с первого раза
  3. Как это выглядит
  4. Почему tg
  5. Что умеет tg
  6. Как это устроено
  7. Начните за пять минут
  8. Ограничения
  9. Найдите инструкцию под свою задачу

Что вы получите

  • Ни одного забытого ответа. Один запрос показывает, кто ждет вашего ответа во всех чатах. Никто не видит, что вы заглядывали.
  • Любое сообщение за секунды. На вопрос "Когда мы договорились с Алисой о месте?" агент дает дату и само сообщение, без интернета. Поиск находит слово в любой форме, а обсуждение целиком по смыслу.
  • Обещания под контролем. "Что я обещал на этой неделе и чего жду от других?" дает один ответ по всем чатам.
  • Голосовые как текст. Голосовые превращаются в текст на вашем компьютере, без Telegram Premium. Текст в файлах и сканах тоже ищется.
  • Спокойные группы. Ссылки, флуд и нежелательных людей обрабатывают ваши правила. Видно вопросы без ответа, кто вступил и кто вышел.
  • Ответы, пока вас нет. Автоответы по вашим правилам, и их можно ограничить людьми, которых вы выбрали.
  • Бот в том же инструменте. Любой бот через официальный Bot API, все 185 методов, рядом с готовыми командами для отправки и ответов.

Что неочевидно с первого раза

  • personal - имя, которое вы выбираете сами. Оно обозначает один аккаунт Telegram, и с него начинается каждая команда. Второй аккаунт можно добавить позже, например как work. Ни одна команда не выбирает аккаунт за вас.
  • Чтение ничего не отмечает прочитанным. Только tg personal chats mark-read показывает собеседнику, что вы прочитали.
  • Ничего не отправляется без команды. Отправка, правка и удаление - отдельные команды, а профиль можно сделать только для чтения.
  • Копия пополняется, пока вы читаете. Чата, который вы еще не открывали и не скачивали, в ней нет. Поэтому пустой результат поиска без интернета не доказывает, что сообщения не было. tg знает, какие отрезки каждого чата у него есть целиком, и говорит об этом.

Как это выглядит

Вы:     Что я кому обещал за последние три дня?
Агент:  (запускает tg personal review 'date>3d': 12 чатов)
        Вы должны
        · Алиса Пример: счет до пятницы. Чат "Алиса Пример", 24.09
        Ждете от других
        · Борис Образец: макет до 25.09. В чате "Дизайн" его пока нет
Вы:     Напомни Борису про макет.
Агент:  Черновик: "Борис, привет, как там макет?" Отправить?
Вы:     Да.

Почему tg

  • Никакого сервера WireCat. tg общается только с Telegram, с вашего компьютера. Аккаунт у нас не нужен.
  • Входит как Telegram для компьютера. Он работает через официальный API Telegram с вашей собственной регистрацией приложения и становится еще одним устройством аккаунта.
  • Поиск, которого не описывают другие. Из пяти открытых инструментов для Telegram в сравнении ни один не описывает поиск сообщения по смыслу, поиск внутри полученных файлов или список того, что вы должны людям и что они должны вам. tg умеет все это.
  • Границы для агента задаете вы. Только чтение, запись только в чаты из вашего списка и не больше 30 отправок в час по умолчанию. Перед отправкой tg может спросить вас в терминале.
  • Вход хранится в связке ключей системы. Ни один другой инструмент в сравнении его там не хранит.
  • Бесплатно и с открытым кодом. Лицензия Apache 2.0, работает на macOS, Linux и Windows.

Другой инструмент подойдет лучше, если вы в основном перекладываете файлы пачками (tdl) или хотите больше всего готовых действий в Claude Desktop без локальной копии (telegram-mcp).

Что умеет tg

  • Разобрать новое: непрочитанное от других людей во всех чатах, обзор того, что изменилось с прошлого раза, вопросы без ответа. Повседневные команды
  • Найти: по человеку, чату, дате, файлу, ссылке и тегу, по смыслу и сразу на сервере Telegram. Поиск
  • Ответить: отправить, ответить, переслать, изменить, закрепить, поставить реакцию, опрос, файл и голосовое. Отложить сообщение на потом. Повседневные команды
  • Вести группу: участники, заявки на вступление, темы, правила модерации, итог недели. Ваши группы
  • Сохранить историю: один раз скачать всю историю чата, выгрузить ее в Markdown или JSONL. Архив сообщений
  • Один человек в разных мессенджерах: свяжите аккаунты человека в Telegram и MAX и ищите сразу по сообщениям, почте и заметкам на этом компьютере. Люди
  • Агенты где угодно: навык для агентов в терминале, MCP-сервер с готовыми запросами для Claude Desktop и Cursor и защищенная ссылка для ChatGPT и Claude в браузере. Агенты

Как это устроено

  • Копия на вашем компьютере. Сообщения, которые tg прочитал или скачал, лежат в локальном архиве. Поиск, выгрузка и чтение без подключения отвечают из него, а поиск может спросить и сервер Telegram. Архив сообщений
  • Вход по QR-коду. Один раз вы регистрируете приложение Telegram, потом сканируете код в Telegram. tg становится еще одним устройством аккаунта.
  • Для скриптов и агентов. Одна операция на вызов и один JSON-ответ с --json. MCP
  • Что хранится и что уходит в сеть. Безопасность

Начните за пять минут

Вставьте это в чат с агентом:

Запрос
Используй tg CLI. Установи его командой npm install -g @wirecat/tg-cli, помоги мне пройти tg personal setup и покажи, кто ждет моего ответа.

Или в терминале:

npm install -g @wirecat/tg-cli
tg personal setup     # регистрация приложения Telegram, вход по QR-коду, навык для агента
tg personal inbox     # непрочитанное от других людей во всех чатах

Нужен Node.js 22.19 или новее в ветке 22, либо 24 и новее, либо Bun. setup сам откроет my.telegram.org: Telegram просит каждую программу, которая подключается к аккаунту, зарегистрироваться, и tg заполнит форму. Установка

Ограничения

  • Для поиска по смыслу нужна модель, которую вы скачиваете один раз (219 МБ, общая с max). Поиск по словам работает и без нее.
  • Истории звонков, настроек приватности и стикеров в tg пока нет. Планы

Найдите инструкцию под свою задачу

ЗадачаКуда перейти
Установить, войти, добавить второй аккаунтУстановка, Вход и профили
Читать, искать и отправлять сообщенияПовседневные команды
Составить точный поисковый запросПоиск сообщений
Вести группуВаши группы
Готовый запрос для агентаСценарии
Решить, что можно агентуПрава
БотБоты
Точная команда или параметрСправочник команд
Что-то не работаетРешение проблем
Чем tg отличается от других инструментов для TelegramСравнение