telegram-mcp

telegram-mcp — MCP-сервер сообщества (автор — chigwell). Интеграция с API Telegram: диалоги, каналы и группы, получение и отправка сообщений, отметки о прочтении. Ставится через npx или через uvx. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
chigwell
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
python

Уровень риска: high

Действует от имени вашего аккаунта Telegram: читает переписки, отправляет и удаляет сообщения, управляет группами. Строка сессии даёт полный доступ к аккаунту. Используйте режим `TELEGRAM_EXPOSED_TOOLS=read-only` и список `TELEGRAM_ALLOWED_CHAT_IDS`.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"telegram-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\"--directory\", \"/full/path/to/telegram-mcp\", \"run\", \"main.py\"],\n      \"env\": {\n        \"TELEGRAM_API_ID\": \"your_api_id_here\",\n        \"TELEGRAM_API_HASH\": \"your_api_hash_here\",\n        \"TELEGRAM_SESSION_STRING\": \"your_session_string_here\"\n      }\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Из README проекта",
    "verified": "docs"
}

Что умеет

Telegram MCP (chigwell/telegram-mcp) — сервер сообщества, который подключает ИИ-ассистента к вашему аккаунту Telegram. Работа идёт от имени пользователя через Telegram API, а не через бота: ассистенту доступны ваши чаты, сообщения и контакты.

По README в сервере больше 80 инструментов в нескольких группах:

  • Аккаунты: список настроенных аккаунтов и выбор аккаунта для вызова.
  • Чаты и группы: список чатов и их данные, создание групп и каналов, вступление и выход, приглашение и удаление участников, администраторы, баны, права по умолчанию, медленный режим и темы.
  • Сообщения: отправка, отложенная отправка, правка, удаление, пересылка, закрепление, отметка о прочтении, ответы, поиск, опросы, реакции, нажатие инлайн-кнопок и экспорт истории чата.
  • Контакты: список, поиск, добавление, удаление, блокировка, импорт и экспорт, проверка номера телефона без добавления в контакты.

Есть режим только для чтения: переменная TELEGRAM_EXPOSED_TOOLS со значением read-only оставляет ассистенту только инструменты чтения.

Кому подойдёт

  • Тем, кто ведёт много чатов и хочет, чтобы ассистент находил нужные сообщения, делал сводки и готовил ответы.
  • Администраторам групп и каналов, которым нужны массовые действия: приглашения, права, закрепы.
  • Разработчикам ассистентов, которым нужен доступ к Telegram из Claude, Cursor или Claude Code.

Не подойдёт, если вы не готовы давать ассистенту доступ к личному аккаунту: строка сессии даёт полный доступ к нему.

Установка

Нужны Python 3.10+ и ключи Telegram API с my.telegram.org/apps. README предупреждает: не ставьте сервер командами uvx telegram-mcp или pip install telegram-mcp — имя telegram-mcp на PyPI принадлежит другому проекту. Ставьте из репозитория:

git clone https://github.com/chigwell/telegram-mcp.git
cd telegram-mcp
uv sync

Затем создайте строку сессии (вход по QR-коду или по номеру телефона):

uv run session_string_generator.py

И заполните файл .env значениями TELEGRAM_API_ID, TELEGRAM_API_HASH и TELEGRAM_SESSION_STRING. Для Claude Desktop репозиторий можно упаковать в расширение .mcpb командой npx @anthropic-ai/mcpb pack . telegram-mcp.mcpb.

Подключение к клиентам

Конфиги взяты из README проекта. Путь к каталогу и ключи замените на свои. Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "telegram-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

Проверка

Перезапустите клиент и попросите ассистента показать список последних чатов. Он должен вызвать list_chats. Если сервер не стартует, проверьте значения в .env и что строка сессии создана для нужного аккаунта.

Инструменты

Группа Примеры инструментов Доступ
Чаты list_chats, get_chat чтение
Сообщения get_messages, search_global чтение
Отправка send_message, reply_to_message запись
Реакции и опросы send_reaction, create_poll, vote_poll запись
Инлайн-кнопки list_inline_buttons, press_inline_button запись
Администрирование invite_to_group, promote_admin, demote_admin запись

Примеры задач

Найди в рабочих чатах сообщения про релиз за последнюю неделю и сделай сводку.
Покажи непрочитанные сообщения в канале и предложи короткие ответы.
Создай опрос в группе с тремя вариантами даты встречи.

Риски

Сервер действует от имени вашего аккаунта: читает личные и рабочие переписки, отправляет и удаляет сообщения, управляет группами. Строка сессии даёт полный доступ к аккаунту. Тексты сообщений — недоверенный контент: по README сервер очищает их и помечает как пользовательские данные, но риск промпт-инъекций остаётся.

Как снизить риски: включите режим TELEGRAM_EXPOSED_TOOLS=read-only, ограничьте доступные чаты списком TELEGRAM_ALLOWED_CHAT_IDS, не публикуйте .env и файлы сессий. Лицензия — Apache-2.0.

Частые вопросы

Это бот или мой аккаунт?

Ваш аккаунт: сервер работает через Telegram API от имени пользователя по строке сессии.

Можно ли запретить ассистенту отправлять сообщения?

Да. Значение read-only в переменной TELEGRAM_EXPOSED_TOOLS оставляет только инструменты чтения.

Почему нельзя ставить через pip?

Имя telegram-mcp на PyPI занято другим проектом. README советует ставить сервер только из репозитория.

Основы протокола — на странице что такое MCP-сервер, другие серверы — в категории коммуникации.

Инструменты

  • list_chats
  • get_messages
  • search_global
  • send_message
  • reply_to_message
  • create_poll
  • press_inline_button
  • promote_admin

Похожие MCP-серверы

Ruflo

Команды и рои агентов, память и хуки для Claude Code и Codex.

Риск: medium Лицензия: MIT ★ 82 058

PraisonAI

Фреймворк агентов PraisonAI с саморефлексией и поддержкой MCP.

Риск: medium Лицензия: MIT ★ 9 327

mcp-atlassian

Поиск, чтение, создание и управление контентом Confluence и Jira, включая Server и Data Center.

Риск: high Лицензия: MIT ★ 6 118

Jitsu

Управление пайплайнами данных Jitsu: направления, потоки, подключения и функции.

Риск: medium Лицензия: MIT ★ 5 132

Источники