telegram-notify-mcp

telegram-notify-mcp — MCP-сервер сообщества (автор — ParthJadhav). Отправка уведомлений в Telegram от ИИ-агентов: текст, фото и документы. Лицензия MIT.

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

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

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

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

Только отправляет уведомления от вашего бота, но может отправить любой доступный файл по пути. Храните токен бота в переменных окружения.

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

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"telegram\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@parthj/telegram-notify-mcp\"],\n      \"env\": {\n        \"TELEGRAM_BOT_TOKEN\": \"your-bot-token\",\n        \"TELEGRAM_USERNAME\": \"your-telegram-username\"\n      }\n    }\n  }\n}",
    "file": "~/.cursor/mcp.json",
    "lang": "json",
    "notes": "Тот же блок; README называет Cursor",
    "verified": "docs"
}

Что умеет

Telegram Notify MCP — простой MCP-сервер с одной задачей: присылать вам в Telegram сообщения о ходе работы ИИ-агента. Управления чатами, администрирования групп и встроенных запросов нет — только уведомления текстом, картинками или файлами. Вы запускаете агента, отходите от компьютера и получаете сообщение, когда он закончит или пока он работает.

Инструментов всего три:

  • send_message — текстовое сообщение, с необязательной разметкой HTML, Markdown или MarkdownV2;
  • send_photo — изображение по URL или абсолютному пути к файлу (скриншот, график, сгенерированная картинка) с подписью;
  • send_document — файл по URL или абсолютному пути с подписью.

При первом вызове сервер находит ваш chat ID по имени пользователя через метод getUpdates Bot API и кеширует его на время работы процесса.

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

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

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

Установка

  1. Напишите @BotFather в Telegram, отправьте /newbot, следуйте подсказкам и скопируйте токен бота.
  2. Найдите своего бота и отправьте ему /start. Без этого бот не сможет узнать ваш chat ID: боты в Telegram пишут только тем, кто начал с ними диалог.
  3. Добавьте сервер в MCP-клиент с переменными TELEGRAM_BOT_TOKEN (токен бота) и TELEGRAM_USERNAME (ваше имя пользователя без @). Обе переменные обязательны. Сервер запускается через npx, пакет @parthj/telegram-notify-mcp.

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

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

claude mcp add telegram -e TELEGRAM_BOT_TOKEN=your-token -e TELEGRAM_USERNAME=your-username -- npx @parthj/telegram-notify-mcp

Проверка

Попросите агента: «Пришли мне в Telegram сообщение "проверка связи"». Если сообщение не пришло, убедитесь, что вы отправили боту /start и правильно указали имя пользователя.

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

Когда закончишь прогон тестов, пришли мне в Telegram итог и число упавших тестов.
Сделай скриншот готовой страницы и отправь его мне в Telegram с подписью.

Риски

Сервер только отправляет сообщения от имени вашего бота. Но send_photo и send_document принимают абсолютный путь к файлу, поэтому агент может отправить в чат любой доступный ему файл, в том числе с конфиденциальными данными. Токен бота даёт полный контроль над ботом.

Как снизить риски: храните токен в переменных окружения и не публикуйте конфиг с ним, следите, какие файлы агент отправляет. Лицензия — MIT.

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

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

Сначала отправьте боту /start: боты в Telegram могут писать только тем, кто начал с ними диалог.

Может ли агент читать мои чаты?

Нет. У сервера три инструмента, и все они только отправляют сообщения.

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

Инструменты

  • send_message
  • send_photo
  • send_document

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

Ruflo

Команды и рои агентов, память и хуки для Claude Code и Codex.

Риск: medium Лицензия: MIT ★ 82 058

PraisonAI

Фреймворк агентов PraisonAI с саморефлексией и поддержкой MCP.

Риск: medium Лицензия: MIT ★ 9 327

mcp-atlassian

Поиск, чтение, создание и управление контентом Confluence и Jira, включая Server и Data Center.

Риск: high Лицензия: MIT ★ 6 118

Jitsu

Управление пайплайнами данных Jitsu: направления, потоки, подключения и функции.

Риск: medium Лицензия: MIT ★ 5 132

Источники