mcp-telegram (sparfenyuk)
MCP Telegram для чтения: агент получает список диалогов и непрочитанные сообщения вашего аккаунта через MTProto, писать от вашего имени он не умеет
- 190 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сессия открывает личную переписку аккаунта: ассистент видит все диалоги и сообщения, которые отдает сервер
- API hash и сессия входа дают доступ к аккаунту, потерянный хеш перевыпустить нельзя
Установка
- Работает в
- Сервисы
Ручная установка
uv tool install git+https://github.com/sparfenyuk/mcp-telegramКоманда из документации, нужен uv.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сессия открывает личную переписку аккаунта: ассистент видит все диалоги и сообщения, которые отдает сервер
- API hash и сессия входа дают доступ к аккаунту, потерянный хеш перевыпустить нельзя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP Telegram от `sparfenyuk` подключает ассистента к вашему личному аккаунту Telegram по протоколу MTProto. Сервер написан на Python с библиотекой Telethon и работает на вашем компьютере. Сейчас доступно два действия, оба на чтение: получить список диалогов (чаты, каналы, группы) и получить сообщения выбранного диалога, в том числе только непрочитанные. Практический сценарий из документации один: попросить ассистента сделать сводку непрочитанных сообщений. Отметка «прочитано», выбор сообщений по дате, скачивание медиа, список контактов и черновики в планах автора и пока не реализованы. Отправки и удаления сообщений в сервере нет, поэтому он подходит тем, кому нужен только обзор переписки.
Для кого. Для тех, кто работает в Claude Desktop и хочет получать сводки по накопившимся сообщениям Telegram без права ассистента писать от их имени.
Подходит, если
- Нужна сводка непрочитанных сообщений из рабочих чатов и каналов после выходных
- Хотите посмотреть список своих диалогов и групп прямо в окне ассистента
- Нужен безопасный старт с MCP для Telegram: сервер только читает, отправки сообщений в нем нет
- Проверяете идею с MCP-инструментами в CLI: команда uv `run` cli.py `list-tools` выводит все инструменты, `call-tool` запускает любой из них
Не подходит, если
- Ассистент должен отправлять, править или удалять сообщения: этих инструментов в сервере нет, для записи есть другие серверы Telegram
- Нужен поиск сообщений по дате, скачивание вложений или список контактов: эти пункты в планах автора
- Нужна работа через Bot API от имени бота, а не личного аккаунта: сервер входит по номеру телефона
- Аккаунт нельзя оставлять под угрозой ограничений: автор сам предупреждает о возможной блокировке за нарушение правил Telegram API
Пример запроса к агенту
Покажи мои непрочитанные сообщения в Telegram за сегодня и сделай короткую сводку по каждому чату.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
TELEGRAM_API_IDобязательная- Числовой API ID приложения с my.telegram.org
TELEGRAM_API_HASHобязательная, секрет- API hash приложения; Telegram не дает его перевыпустить
Ограничения
Нужны API ID и API hash с my.telegram.org, номер телефона и код из Telegram. Если включена двухфакторная защита, потребуется и пароль. Хеш нельзя перевыпустить, поэтому храните его в секрете.
Требуются Python 3.11 или новее и инструмент uv. Пример конфигурации в документации описан для Claude Desktop; другие клиенты автор не упоминает. В примере команда названа mcp-server, а в pyproject зарегистрирована команда mcp-telegram: используйте ее.
Последнее обновление репозитория датировано мартом 2025 года. Автор предупреждает, что нарушение правил Telegram API может привести к блокировке аккаунта. Доступность самого Telegram из России зависит от оператора и при подготовке карточки не проверялась.
Как отключить. Уберите блок mcp-telegram из файла claude_desktop_config.json. Выйти из аккаунта можно командой mcp-telegram `logout`, удалить сервер командой uv tool `uninstall` mcp-telegram. После выхода сессия на вашем компьютере больше не открывает аккаунт.
Частые вопросы
Как поставить MCP Telegram в Claude Desktop?
Установите uv, затем выполните uv tool install git+https://github.com/sparfenyuk/mcp-telegram. После этого войдите командой mcp-telegram sign-in с API ID, API hash и номером телефона, введите код из Telegram и добавьте сервер в claude_desktop_config.json с переменными TELEGRAM_API_ID и TELEGRAM_API_HASH.
Может ли этот MCP Telegram отправлять сообщения?
Нет. Сервер дает доступ только на чтение: список диалогов и сообщения диалога, в том числе непрочитанные. Отправка, черновики и отметка о прочтении в списке будущих функций.
Где взять API ID и API hash для Telegram?
На странице my.telegram.org: войдите с номером телефона, откройте раздел API Development `tools` и создайте приложение. Достаточно заполнить название и короткое имя. Хеш нельзя перевыпустить, никуда его не публикуйте.
Чем mcp-telegram от `sparfenyuk` отличается от dryeab/mcp-telegram?
Репозиторий `sparfenyuk` умеет только читать диалоги и сообщения, у `dryeab` есть отправка, правка, удаление, поиск, черновики и скачивание медиа. У `sparfenyuk` меньше возможностей и меньше шанс случайной записи.
Как выйти из аккаунта и удалить MCP Telegram?
Команда mcp-telegram `logout` завершает вход, команда uv tool `uninstall` mcp-telegram удаляет сервер. Блок mcp-telegram в файле claude_desktop_config.json тоже уберите.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыMCP Telegram с записью: агент отправляет, правит и удаляет сообщения, ищет чаты, ведет черновики и скачивает медиа в вашем аккаунте через MTProto
Telegram MCP от chaindead
Telegram MCP
MCP-сервер на Go для вашего Telegram: агент читает диалоги и непрочитанное, отмечает прочитанным, ответы кладет в черновики
MCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
MCP-сервер для почты Mail.ru в Claude.ai и отдельный Telegram-бот, который каждые 15 минут проверяет ящик и присылает уведомления о важных письмах
MCP доставки отчетов Трекера в Telegram
Telegram Delivery MCP
Вспомогательный MCP-сервер, который берет готовый отчет по задачам Яндекс Трекера и отправляет его в Telegram через существующий бот-сервис
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-telegram (sparfenyuk) (эта запись) | нет | API-ключ | 190 | |
| mcp-telegram (dryeab) | нет | API-ключ | 254 | другой MCP Telegram с отправкой, правкой, удалением и поиском сообщений |
| Telegram MCP Server | нет | API-ключ | 1 933 | MCP-сервер на Telethon, где агент читает и отправляет сообщения и управляет чатами |
| Telegram API MCP | нет | API-ключ | 33 | работа через Bot API от имени бота, а не личного аккаунта |
Коротко о README
В документации перечислены функции (готовы список диалогов и сообщений, остальное в планах), требования (инструмент uv), установка одной командой, вход по API ID, API hash и телефону, пример конфигурации для Claude Desktop и раздел отладки через CLI и MCP Inspector. Для добавления собственного инструмента достаточно описать класс аргументов в файле `tools`.py и зарегистрировать функцию.