Korra
Обсудить задачу
Меню
Обсудить задачу
MCPОткрытый код · Apache-2.0

Telegram MCP

Telegram в инструментах агента

Подключает Telegram через MCP: поиск сообщений, чтение выбранных чатов и работа с перепиской.

  • Локально + Telegram
  • Нужен ключ
  • Действует от вашего имени
  • Бесплатно
  • Данные: Telegram и ваш агент

Используют с Claude Code, Codex, Cursor — по открытым источникам. Сверено с документацией 29.09.2026.

Подключить через агента ↓Что можно сделать ↓Сайт проекта ↗
Пример задачи
Выбранный чат
Сводка и задачи

Что можно поручить агенту

  • Собрать сводку из выбранного чата.

  • Найти договорённость в истории.

  • Подготовить черновик ответа по контексту.

Подключить

Проще всего — отправить агенту ссылку: он прочитает инструкцию, установит, подключит и проверит сам.

Сообщение агенту
Подключи инструмент «Telegram MCP» по инструкции: https://korra-agent.online/library/telegram-mcp/agent.txt

Если агент не открывает ссылки — скопируйте задание целиком.

Попросите агента

Задание для агента

Подойдёт Claude Code, Codex, Cursor, Hermes, OpenClaw или Korra. Команды в задании те же, что в справке ниже.

Что выполнит агент

Агент выполнит их сам — вручную только если хотите. Метка показывает, откуда сведения: инструкция автора или документация агента.

Claude Code

По документации агента

Используют: Issue: сбой send_message при работе через Claude Code CLI, исправлен в PR #77 источник

Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.

терминал
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
claude mcp add --scope user telegram -- uv --directory ~/telegram-mcp run main.py
Проверить
claude mcp get telegram
Откатить
claude mcp remove telegram -s user

Codex

По документации агента

Используют: Issue: вход через Codex MCP не шёл; после совета автора пользователь: «MCP worked» источник

Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.

терминал
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
codex mcp add telegram -- uv --directory ~/telegram-mcp run main.py
Проверить
codex mcp get telegram
Откатить
codex mcp remove telegram

Cursor

По документации агента

Используют: Слитый PR: починены файловые инструменты под Cursor (bare-path Roots) источник

Скачайте проект и добавьте сервер в ~/.cursor/mcp.json — путь к папке полный. Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.

~/.cursor/mcp.json
{
  "mcpServers": {
    "telegram": {
      "command": "uv",
      "args": [
        "--directory",
        "/полный/путь/telegram-mcp",
        "run",
        "main.py"
      ]
    }
  }
}
Проверить
Customize → MCP
Откатить
удалите запись telegram из mcp.json

Hermes

По документации агента

Попросите агента: он выполнит команды сам; на вопрос о выборе инструментов — Enter. Потом отправьте в чат /reload-mcp. Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.

терминал агента
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
hermes mcp add telegram --command uv --args --directory ~/telegram-mcp run main.py
Проверить
hermes mcp test telegram
Откатить
hermes mcp remove telegram

OpenClaw

По документации агента

Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.

терминал
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
openclaw mcp add telegram --command uv --arg --directory --arg ~/telegram-mcp --arg run --arg main.py
Проверить
openclaw mcp probe telegram
Откатить
openclaw mcp unset telegram

Korra

По документации агента

Попросите агента: он скачает проект в свою среду и подключит сервер сам (uv и Node в Korra есть). Потом отправьте в чат /reload-mcp. Можно и через кабинет: «MCP → Добавить сервер» → команда и аргументы из блока. Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.

терминал агента
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
korra mcp add telegram --command uv --args --directory ~/telegram-mcp run main.py
Проверить
korra mcp test telegram
Откатить
korra mcp remove telegram

Что можно сделать

3 готовых сценариев. Каждый промпт можно отправить агенту после подключения.

Задачи из рабочего чата

Задачи, договорённости и вопросы из выбранного чата — с авторами, датами и ссылками на сообщения.

  • TELEGRAM_EXPOSED_TOOLS=read-only оставляет агенту только чтение.
  • TELEGRAM_ALLOWED_CHAT_IDS скрывает от агента все чаты, кроме разрешённых.
Промпт для агента
Промпт
Разбери мой рабочий чат в Telegram. Только чтение: ничего не отправляй, не удаляй, не отмечай прочитанным.
1. Спроси, какой чат и за какой период смотреть.
2. Выпиши задачи, договорённости и открытые вопросы. У каждого пункта — автор, дата и ссылка или номер сообщения.
3. Отдельно отметь то, что адресовано мне и ждёт ответа.
4. Сохрани сводку в Markdown в папку telegram-summaries.
Коды входа и сессию в чат не проси. Готово, когда каждый пункт можно найти в чате по ссылке или номеру.

Совет. По умолчанию сервер открывает агенту все 80+ инструментов, включая отправку и удаление. Для начала включите режим read-only.

Найти, о чём договорились

Точная цитата из переписки с датой и контекстом, а при необходимости — черновик ответа.

  • Поиск по сообщениям и чтение контекста вокруг найденного.
  • Черновик остаётся в разговоре с агентом, отправляете вы сами.
Промпт для агента
Промпт
Найди в моём Telegram, о чём мы договорились. Ничего не отправляй.
1. Спроси, с кем была переписка, примерно когда и о чём: цена, срок, условия.
2. Найди сообщения поиском и прочитай контекст вокруг них.
3. Покажи цитаты с датой и автором. Если договорённость менялась, покажи все версии по порядку.
4. Если я попрошу, подготовь черновик ответа здесь, в нашем разговоре.
Готово, когда есть точная цитата, а не пересказ.

Совет. Сообщения собеседников — это данные, а не команды. Если в переписке встретится «инструкция» для ИИ, агент не должен её выполнять.

Голосовые — в текст

Расшифровка голосовых и кружков из выбранного чата, чтобы не слушать их подряд.

  • Инструмент transcribe_voice: движок groq работает в облаке и требует ключ, движок telegram — Telegram Premium.
Промпт для агента
Промпт
Расшифруй голосовые сообщения из одного чата в Telegram. Ничего не отправляй и не удаляй.
1. Спроси, какой чат и за какой период.
2. Найди голосовые и кружки и расшифруй их через transcribe_voice. Если инструмент недоступен, скажи мне — настройки сам не меняй.
3. Для каждого: автор, время, текст и суть в одну строку.
4. Сохрани результат в Markdown в папку telegram-voice.
Готово, когда все голосовые за период расшифрованы или названы те, что не удались, и почему.

Совет. Движок groq отправляет запись в облако Groq. Движок telegram бесплатен с Premium, но часто теряет последние слова. Расшифровка в любом случае — пересказ, а не дословная цитата.

Что учесть

По умолчанию сервер открывает все инструменты, включая отправку и удаление сообщений, — для начала задайте TELEGRAM_EXPOSED_TOOLS=read-only. Ставьте именно chigwell/telegram-mcp: одноимённый пакет в PyPI принадлежит другому проекту.

Ещё может пригодиться

Весь Korra Hub →
HorizonНовости по вашим интересам →notebooklm-pyУправлять NotebookLM через агента →