Telegram MCP Server
MCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
- 1 933 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Строка сессии дает полный доступ к аккаунту Telegram
- Может отправлять и удалять сообщения, менять участников и настройки чатов
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/chigwell/telegram-mcp.git
cd telegram-mcp
uv sync
uv run session_string_generator.pyСкрипт выдаст строку сессии, храните ее как пароль.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Строка сессии дает полный доступ к аккаунту Telegram
- Может отправлять и удалять сообщения, менять участников и настройки чатов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к пользовательскому аккаунту Telegram через Telethon. Агент может искать и читать переписку, отправлять, планировать, редактировать и пересылать сообщения, создавать группы и каналы, управлять админами, контактами, папками и черновиками. Контактам можно задать привычные имена, и при неточном совпадении сервер не отправляет сообщение, а просит подтверждение. Голосовые сообщения расшифровываются через Groq или встроенную расшифровку Telegram Premium.
Для кого. Для тех, кто ведет рабочую переписку в Telegram и хочет разбирать и отвечать на нее через агента.
Подходит, если
- Нужна сводка непрочитанных чатов
- Нужно найти старое сообщение и ответить на него
- Нужно разослать сообщение или создать группу с участниками
Не подходит, если
- Нужен бот, а не доступ к личному аккаунту
- Нельзя передавать сессию аккаунта процессу на компьютере
Пример запроса к агенту
Покажи непрочитанные сообщения из рабочих чатов и предложи короткие ответы, ничего не отправляй без подтвержденияMCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
TELEGRAM_API_IDобязательная, секрет- API id приложения с my.telegram.org.
TELEGRAM_API_HASHобязательная, секрет- API hash приложения с my.telegram.org.
TELEGRAM_SESSION_STRINGобязательная, секрет- Строка сессии аккаунта из генератора.
TELEGRAM_EXPOSED_TOOLS- all, read-only или read-only+список инструментов.
GROQ_API_KEYсекрет- Ключ Groq для расшифровки голосовых.
Ограничения
Нужны API id и hash с my.telegram.org и строка сессии, которая дает полный доступ к аккаунту. Режим TELEGRAM_EXPOSED_TOOLS=read-only скрывает инструменты записи, но саму сессию не ограничивает. Много параллельных сессий Telegram может ограничить. Пакет telegram-mcp на PyPI принадлежит другому проекту, ставить нужно из репозитория. Расшифровка через Groq требует ключа и доступа к зарубежному API, а работа Telegram в России бывает нестабильной.
Как отключить. Удалите блок telegram-mcp из конфигурации MCP и завершите сессию в Telegram в разделе Настройки, Устройства.
Частые вопросы
Можно ли запретить агенту отправлять сообщения?
Да, TELEGRAM_EXPOSED_TOOLS=read-only оставляет только чтение, а через read-only+send_message можно добавить отдельные инструменты записи.
Можно ли подключить несколько аккаунтов?
Да, через переменные TELEGRAM_SESSION_STRING_<метка>. Для записи агент должен указать аккаунт.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыTelegram MCP от chaindead
Telegram MCP
MCP-сервер на Go для вашего Telegram: агент читает диалоги и непрочитанное, отмечает прочитанным, ответы кладет в черновики
MCP Telegram с записью: агент отправляет, правит и удаляет сообщения, ищет чаты, ведет черновики и скачивает медиа в вашем аккаунте через MTProto
Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
MCP Telegram для чтения: агент получает список диалогов и непрочитанные сообщения вашего аккаунта через MTProto, писать от вашего имени он не умеет
TGStat MCP
tgstat-mcp
MCP-сервер TGStat: поиск Telegram-каналов и постов, динамика подписчиков и охватов, ERR и упоминания
MCP-сервер для почты Mail.ru в Claude.ai и отдельный Telegram-бот, который каждые 15 минут проверяет ящик и присылает уведомления о важных письмах
Из блога
Коротко о README
README описывает группы инструментов для аккаунтов, чатов, сообщений, контактов, медиа, профиля, папок и событий. Установка идет из клона репозитория через uv, сессия создается скриптом по QR-коду или номеру телефона. Сервер работает по stdio, Streamable HTTP и SSE, общий HTTP-процесс советуют, когда клиентов несколько. Отдельно разобраны несколько аккаунтов, пул сессий, прокси, Docker и безопасность путей к файлам. Лицензия Apache-2.0.