telegram-mcp — MCP-сервер для Claude Code: Telegram из чата
Подключает ваш личный аккаунт Telegram к ИИ-агенту: читать чаты, искать сообщения, отправлять ответы и скачивать медиа прямо из диалога с ассистентом.
claude mcp add telegram-mcp -- uvx telegram-mcp-jgaleaЧто делает telegram-mcp
Сервер работает через MTProto (Telethon), а не через Bot API. Поэтому агенту видны те же личные чаты, группы, каналы и медиа, что и в приложении Telegram. Инструментов около сорока: список диалогов, чтение и поиск сообщений по ключевому слову или регулярному выражению, отправка, редактирование, пересылка, отложенные сообщения, реакции, работа с контактами и группами.
Сообщения кэшируются в локальный SQLite по мере работы. Отдельного шага синхронизации нет — история накапливается сама и становится доступной для поиска. Файл сессии лежит в ~/.telegram-mcp/session.session с ограниченными правами, учётные данные не хранятся в конфигах, есть ограничение частоты запросов.
Перед первым запуском нужны api_id и api_hash с my.telegram.org, а вход интерактивный: Telegram присылает код на телефон, и его надо ввести в терминале самому. Агент эту часть не сделает — он способен только прописать конфиг MCP и склонировать репозиторий. Без выполненного telegram-mcp login инструменты возвращают ошибки или пустые результаты, и агент может начать уверять, что сервер видит только переписку с ботом. Это не так: причина почти всегда в незавершённом входе.
Какие задачи решает
- прочитать непрочитанные сообщения в рабочих группах
- найти ссылку из переписки за прошлую неделю
- ответить в личный чат, не открывая приложение
- скачать присланный файл или медиа
- создать группу и закрепить в ней сообщение
Примеры запросов агенту
- Покажи непрочитанные сообщения за сегодня
- Найди в чате с Аней сообщения про договор
- Отправь в группу «Команда» сообщение: созвон переносим на час позже
Как установить telegram-mcp
Командой платформы
claude mcp add telegram-mcp -- uvx telegram-mcp-jgaleauvx запускает команду с именем пакета; если в README она другая — uvx --from telegram-mcp-jgalea <команда>
Командой платформы
codex mcp add telegram-mcp -- uvx telegram-mcp-jgaleauvx запускает команду с именем пакета; если в README она другая — uvx --from telegram-mcp-jgalea <команда>
Файл настроек
{
"mcpServers": {
"telegram-mcp": {
"command": "uvx",
"args": [
"telegram-mcp-jgalea"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from telegram-mcp-jgalea <команда>
Файл настроек
{
"servers": {
"telegram-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"telegram-mcp-jgalea"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from telegram-mcp-jgalea <команда>
Командой платформы
gemini mcp add telegram-mcp uvx telegram-mcp-jgaleauvx запускает команду с именем пакета; если в README она другая — uvx --from telegram-mcp-jgalea <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о telegram-mcp
Как установить telegram-mcp в Claude Code?
Выполните claude mcp add telegram-mcp -- uvx telegram-mcp-jgalea, затем один раз запустите в терминале telegram-mcp login и пройдите вход по номеру телефона.
Что делает telegram-mcp?
Даёт агенту доступ к вашему аккаунту Telegram: чтение и поиск сообщений, отправка и редактирование, работа с группами, каналами, контактами и медиа.
Почему инструменты возвращают ошибки?
Скорее всего, вход не выполнен: установка сервера и вход в Telegram — два разных шага. Запустите telegram-mcp login в настоящем терминале и перезапустите клиент MCP.
