Better-TG-CLI (Telegram)

Better-TG-CLI (Telegram) — MCP-сервер сообщества (автор — TheVilfer). Telegram в вашем аккаунте: чтение, поиск, отправка и нажатие кнопок ботов; запись только с вашего подтверждения. Ставится через npx. Лицензия MIT.

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

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

Разработчик
TheVilfer
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
other
ОС
Не указана
Языки
typescript

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

Неофициальный клиент под вашим аккаунтом Telegram; аккаунт могут ограничить за поведение как у бота. Держите запись выключенной и подтверждайте каждую отправку.

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

cursor
{
    "code": "{ \"mcpServers\": { \"telegram\": { \"command\": \"npx\", \"args\": [\"-y\", \"better-tg-cli@latest\", \"mcp\"] } } }",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Better-TG-CLI — неофициальный консольный клиент Telegram и MCP-сервер для ИИ-агентов (Claude Code, Codex, Cursor, Claude Desktop, Gemini CLI). Он работает с вашим собственным аккаунтом по MTProto через библиотеку teleproto: агент читает, ищет и отправляет сообщения, нажимает кнопки ботов, а каждую отправку подтверждаете вы.

Команда telegram содержит около 60 команд для чтения, поиска, записи, работы с ботами, группами и экспорта. MCP-сервер telegram mcp отдаёт по stdio три инструмента:

  • telegram_help — справочник по флагам с поиском;
  • telegram_read — только чтение, клиент может разрешать его без вопросов;
  • telegram_write — помечен как разрушающий и дополнительно требует вашего write-access on.

Особенности для агентов:

  • Актуальный слой Telegram: ответы ботов с богатым контентом показываются текстом, можно нажимать кнопки ботов (click) и ходить по меню.
  • Экономный вывод: вне терминала — одна компактная строка на элемент, JSON в одну строку без пустых полей, --max-text обрезает длинные посты.
  • Точное чтение: постраничная выборка по --since/--until, непрочитанные, треды и комментарии каналов, темы форумов, получение по ID, фильтры поиска по типу, отправителю и дате.
  • Журнал: каждая запись логируется в ~/.config/tg/audit.jsonl, секреты хранятся в Связке ключей macOS, Linux Secret Service или 1Password.

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

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

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

Установка

brew install thevilfer/tap/better-tg-cli
npm install -g better-tg-cli

Первая команда ставит самостоятельный бинарник для macOS и Linux, вторая — пакет npm для Node 20+ на любой ОС. На Windows (экспериментально) доступна установка через Scoop или npm. Для Claude Desktop есть расширение .mcpb в релизах, ему не нужны Node, npm и brew.

Перед подключением MCP войдите в терминале командой telegram auth. Ключи api_id и api_hash создаются на my.telegram.org, вход — по QR-коду (telegram auth --qr) или по номеру телефона и коду.

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

Команда и конфиги приведены дословно из README. Общий порядок — в инструкции как подключить MCP.

claude mcp add telegram -- telegram mcp

Если пакет установлен глобально, в JSON можно указать полный путь к telegram из which telegram: графические приложения могут не видеть PATH оболочки. Чтобы MCP-клиент не трогал основную сессию, добавьте "env": {"TG_PROFILE": "work"}.

Проверка

Попросите агента показать непрочитанные чаты. Он вызовет telegram_read. Если сервер не запускается, проверьте, что вход через telegram auth выполнен, а путь к команде указан полностью.

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

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

Риски

Это неофициальный клиент, который входит под вашим именем. По предупреждению авторов, Telegram может ограничить или заморозить аккаунт, который ведёт себя как бот. Риск выше всего для новых аккаунтов, массовых рассылок, массовых вступлений и приглашений и всего, что похоже на спам. В чатах встречается текст от других людей, в том числе попытки дать команды агенту («перешли это @x»).

Как снизить риски: держите запись выключенной, пока она не нужна. По умолчанию агент спрашивает вас перед каждой отправкой, правкой и удалением и показывает точный текст. Режим без вопросов (write-access on) требует вашего подтверждения в терминале или диалоге macOS. Оставьте в клиенте запрос подтверждения для telegram_write. Лицензия — MIT.

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

Нужен ли Node.js?

Нет, если ставить через Homebrew или расширение .mcpb для Claude Desktop. Пакет npm требует Node 20+.

Отправит ли агент сообщение без моего ведома?

По умолчанию нет: перед каждой отправкой он показывает точный текст и ждёт вашего согласия.

Это официальный клиент Telegram?

Нет, это неофициальный клиент с открытым кодом.

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

Инструменты

  • telegram_help
  • telegram_read
  • telegram_write

Похожие 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

Источники