WireCat Telegram

WireCat Telegram — официальный MCP-сервер от WireCatLabs. Доступ ИИ-агента к вашему аккаунту Telegram: чтение, поиск и отправка сообщений после входа через утилиту tg. Ставится через npx. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
WireCatLabs
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
other
ОС
Не указана
Языки
typescript

Уровень риска: high

Работает от имени личного аккаунта Telegram: читает все чаты, отправляет и удаляет сообщения, хранит историю локально. Ограничьте действия и чаты в профиле, включайте `--allow-writes` только после проверки прав.

Настройка клиентов

codex
{
    "code": "tg personal mcp add codex",
    "lang": "bash",
    "notes": "Дословно из README; после проверки прав профиля повторить с --allow-writes",
    "verified": "docs"
}

Что умеет

tg — консольный клиент Telegram для ИИ-агентов. Он работает от имени вашего аккаунта, как ещё одно ваше устройство: подключается к Telegram по MTProto через приложение, которое вы сами регистрируете на my.telegram.org. Агенты с терминалом (Claude Code, Codex, Gemini CLI) вызывают команды tg напрямую, а клиенты без терминала (Claude Desktop, Cursor и другие MCP-клиенты) подключаются к MCP-серверу tg personal mcp serve.

  • Чтение: чаты, история, непрочитанные сообщения других людей во всех чатах (tg personal inbox), всё новое с прошлого просмотра (tg personal review), поток новых сообщений (tg personal watch), файлы и расшифровка голосовых сообщений. Чтение ничего не помечает прочитанным.
  • Отправка: текст с Markdown, ответы, файлы, фото, видео и голосовые, тихие и отложенные сообщения, правка, пересылка, закрепление, реакции, опросы и удаление.
  • Поиск: всё прочитанное хранится в локальной базе на компьютере. Поиск идёт по ней и по умолчанию ещё и через поиск Telegram. С флагом --offline запрос не покидает компьютер.
  • Группы: вопросы без ответа, события участников (кто вошёл, вышел, кого добавили), список участников и тем форума.
  • Контакты и аккаунт: добавление, переименование, блокировка, свои заметки о людях, список устройств аккаунта.
  • Bot API: все методы Bot API рядом с обычными командами.

MCP-сервер идёт с готовыми промптами /catch-up, /review, /reply, /find, /open-tasks и /link-conversations.

Кому подойдёт

  • Тем, кто тонет в переписке: агент собирает, кто ждёт ответа, что вы пообещали и что обещали вам.
  • Администраторам групп: поиск вопросов без ответа и журнал входов и выходов участников.
  • Тем, кто ищет в архиве: локальный поиск по словам, людям, датам, файлам и ссылкам, экспорт чата в Markdown.

Похожие серверы — в категории коммуникации.

Установка

Нужны Node 22.19+ или 24+ либо Bun, на macOS, Linux или Windows. Установка и первичная настройка по README:

npm install -g @wirecat/tg-cli
tg skill install --for all
tg personal setup

tg personal setup регистрирует ваше приложение Telegram, выполняет вход по QR-коду, проверяет первые чаты и ставит навык для агентов. На всё уходит около пяти минут. Загрузка старой истории — отдельный шаг. Попробовать без установки можно командой npx @wirecat/tg-cli --help.

Ключи приложения хранятся в системном хранилище ключей, файл сессии доступен только вашему пользователю. Профиль указывается первым словом команды (tg personal …, tg work …) или через переменную TG_PROFILE.

Подключение к клиентам

Команды приведены дословно из README. Для Claude Desktop, Cursor и других клиентов запись конфига выводит команда tg personal mcp config. Общий порядок — в инструкции как подключить MCP.

tg personal mcp add claude-code

Профиль по умолчанию может отправлять сообщения, поэтому mcp add сначала останавливается. Проверьте разрешения профиля и запустите команду повторно с --allow-writes.

Проверка

Попросите ассистента: «Что пришло с утра и кто ждёт моего ответа?» Он должен вызвать просмотр входящих и вернуть список чатов. Если профиль не выбран, tg остановится и покажет доступные профили.

Примеры задач

Что я пообещал за последние три дня и чего жду от других?
Какие вопросы в группе «Походы» остались без ответа?
Когда мы договорились с Алисой о месте встречи? Покажи само сообщение.

Риски

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

Что встроено: профиль задаёт, какие действия разрешены агенту, в какие чаты можно писать и сколько сообщений в час (по умолчанию 30). Если исход отправки неизвестен, tg сообщает об этом и даёт команду повтора, которую Telegram не доставит дважды. Подключайте MCP с --allow-writes только после проверки прав профиля, для поиска используйте --offline. Лицензия — Apache-2.0.

Частые вопросы

Это бот?

Нет. tg работает от вашего имени как ещё одно устройство и подключается по MTProto через приложение, которое вы регистрируете сами.

Помечает ли агент сообщения прочитанными?

Нет, чтение ничего не помечает прочитанным.

Можно ли подключить несколько аккаунтов?

Да, каждый аккаунт — отдельный профиль. Имя профиля пишется первым словом команды или задаётся через TG_PROFILE.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники