Telegram MCP Server
MCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
Установка
git clone https://github.com/chigwell/telegram-mcp.git
cd telegram-mcp
uv sync
uv run session_string_generator.pyСкрипт выдаст строку сессии, храните ее как пароль.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к пользовательскому аккаунту Telegram через Telethon. Агент может искать и читать переписку, отправлять, планировать, редактировать и пересылать сообщения, создавать группы и каналы, управлять админами, контактами, папками и черновиками. Контактам можно задать привычные имена, и при неточном совпадении сервер не отправляет сообщение, а просит подтверждение. Голосовые сообщения расшифровываются через Groq или встроенную расшифровку Telegram Premium.
Для кого. Для тех, кто ведет рабочую переписку в Telegram и хочет разбирать и отвечать на нее через агента.
Подходит, если
- Нужна сводка непрочитанных чатов
- Нужно найти старое сообщение и ответить на него
- Нужно разослать сообщение или создать группу с участниками
Не подходит, если
- Нужен бот, а не доступ к личному аккаунту
- Нельзя передавать сессию аккаунта процессу на компьютере
Пример запроса к агенту
Покажи непрочитанные сообщения из рабочих чатов и предложи короткие ответы, ничего не отправляй без подтвержденияОграничения
Нужны API id и hash с my.telegram.org и строка сессии, которая дает полный доступ к аккаунту. Режим TELEGRAM_EXPOSED_TOOLS=read-only скрывает инструменты записи, но саму сессию не ограничивает. Много параллельных сессий Telegram может ограничить. Пакет telegram-mcp на PyPI принадлежит другому проекту, ставить нужно из репозитория. Расшифровка через Groq требует ключа и доступа к зарубежному API, а работа Telegram в России бывает нестабильной.
Как отключить. Удалите блок telegram-mcp из конфигурации MCP и завершите сессию в 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 для расшифровки голосовых. |
Проверка безопасности
- Строка сессии дает полный доступ к аккаунту Telegram
- Может отправлять и удалять сообщения, менять участников и настройки чатов
Коротко о README
README описывает группы инструментов для аккаунтов, чатов, сообщений, контактов, медиа, профиля, папок и событий. Установка идет из клона репозитория через uv, сессия создается скриптом по QR-коду или номеру телефона. Сервер работает по stdio, Streamable HTTP и SSE, общий HTTP-процесс советуют, когда клиентов несколько. Отдельно разобраны несколько аккаунтов, пул сессий, прокси, Docker и безопасность путей к файлам. Лицензия Apache-2.0.
Частые вопросы
Можно ли запретить агенту отправлять сообщения?
Да, TELEGRAM_EXPOSED_TOOLS=read-only оставляет только чтение, а через read-only+send_message можно добавить отдельные инструменты записи.
Можно ли подключить несколько аккаунтов?
Да, через переменные TELEGRAM_SESSION_STRING_<метка>. Для записи агент должен указать аккаунт.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании