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
Только отправляет уведомления от вашего бота, но может отправить любой доступный файл по пути. Храните токен бота в переменных окружения.
Настройка клиентов
{
"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 и кеширует его на время работы процесса.
Кому подойдёт
- Тем, кто запускает долгие задачи агента: сборки, рефакторинг, генерацию отчётов — и хочет узнать о завершении на телефоне.
- Тем, кому нужен отчёт с картинкой: агент присылает скриншот или график прямо в чат.
- Тем, кто не хочет давать агенту доступ к личному аккаунту: сервер работает через отдельного бота и умеет только отправлять уведомления.
Похожие серверы — в категории коммуникации.
Установка
- Напишите @BotFather в Telegram, отправьте
/newbot, следуйте подсказкам и скопируйте токен бота. - Найдите своего бота и отправьте ему
/start. Без этого бот не сможет узнать ваш chat ID: боты в Telegram пишут только тем, кто начал с ними диалог. - Добавьте сервер в 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.
PraisonAI
Фреймворк агентов PraisonAI с саморефлексией и поддержкой MCP.
mcp-atlassian
Поиск, чтение, создание и управление контентом Confluence и Jira, включая Server и Data Center.
Jitsu
Управление пайплайнами данных Jitsu: направления, потоки, подключения и функции.