Telegram MCP-сервер и CLI для личного аккаунта
ИИ-агент читает ваш Telegram, говорит, кто ждет ответа, и находит любое сообщение без интернета. Ничего не отмечается прочитанным и не отправляется без вашей просьбы.
Вы видите, кто вас ждет, не листая чаты. tg подключает ваш собственный аккаунт Telegram к ИИ-агенту, которым
вы уже пользуетесь, например Claude Code, Codex или Cursor. Он хранит копию чатов на вашем компьютере, поэтому агент
ищет по переписке за годы, даже без интернета.
Агент скажет, в каких чатах ждут ответа, что вы обещали на этой неделе и куда Алиса прислала PDF с договором аренды. Он отвечает сообщениями, которые нашел, и готовит черновик ответа, который вы отправляете или правите. Настройка занимает около пяти минут.
На этой странице:
- Что вы получите
- Что неочевидно с первого раза
- Как это выглядит
- Почему tg
- Что умеет tg
- Как это устроено
- Начните за пять минут
- Ограничения
- Найдите инструкцию под свою задачу
Что вы получите
- Ни одного забытого ответа. Один запрос показывает, кто ждет вашего ответа во всех чатах. Никто не видит, что вы заглядывали.
- Любое сообщение за секунды. На вопрос "Когда мы договорились с Алисой о месте?" агент дает дату и само сообщение, без интернета. Поиск находит слово в любой форме, а обсуждение целиком по смыслу.
- Обещания под контролем. "Что я обещал на этой неделе и чего жду от других?" дает один ответ по всем чатам.
- Голосовые как текст. Голосовые превращаются в текст на вашем компьютере, без 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 | Сравнение |