telegram-mcp

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

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

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

Разработчик
chaindead
Лицензия
MIT
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
go

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

Доступ ко всей переписке личного аккаунта Telegram; сессия хранится локально. Нарушение условий Telegram API может привести к блокировке аккаунта. `tg_send` создаёт черновики — проверяйте их перед отправкой.

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

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"telegram-mcp\": {\n      \"command\": \"telegram-mcp\",\n      \"env\": {\n        \"TG_APP_ID\": \"<your-app-id>\",\n        \"TG_API_HASH\": \"<your-api-hash>\"\n      }\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Telegram MCP server от chaindead связывает Telegram API с ИИ-ассистентом. Сервер работает от имени вашего личного аккаунта, а не через Bot API: ассистент видит ваши диалоги и может готовить ответы. Написан на Go и распространяется готовым бинарником.

  • Показывает данные текущего аккаунта (tg_me).
  • Выводит список диалогов, при желании только непрочитанные (tg_dialogs).
  • Читает сообщения конкретного диалога (tg_dialog).
  • Отмечает диалог прочитанным (tg_read).
  • Сохраняет черновик сообщения в любом диалоге (tg_send).

Инструмент tg_send по README создаёт черновик, а не отправляет сообщение сразу. Последнее слово остаётся за вами.

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

  • Тем, у кого много чатов: ассистент соберёт сводку непрочитанного и выделит важное.
  • Тем, кто хочет навести порядок: README предлагает просить ассистента разложить чаты по папкам и важности.
  • Тем, кто отвечает на однотипные вопросы: ассистент подготовит черновики ответов, которые вы проверите перед отправкой.

Если нужно больше действий (группы, контакты, медиа), посмотрите другие серверы из категории коммуникации.

Установка

Самый простой вариант — запуск через npx на macOS, Linux и Windows:

npx -y @chaindead/telegram-mcp

Другие способы из README:

brew install chaindead/tap/telegram-mcp
go install github.com/chaindead/telegram-mcp@latest

Ещё можно скачать бинарник со страницы релизов. Для сборки из исходников нужен Go 1.24 или новее.

Авторизация

  1. Получите API ID и API hash на странице my.telegram.org.
  2. Выполните вход и введите код, который пришлёт Telegram:
telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>

Если включена двухфакторная защита, добавьте --password. Чтобы заменить существующую сессию, добавьте --new. При запуске через npx команда начинается с npx -y @chaindead/telegram-mcp auth.

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

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

claude_desktop_config.json
{
  "mcpServers": {
    "telegram": {
      "command": "telegram-mcp",
      "env": {
        "TG_APP_ID": "<your-app-id>",
        "TG_API_HASH": "<your-api-hash>",
        "PATH": "<path_to_telegram-mcp_binary_dir>",
        "HOME": "<path_to_your_home_directory"
      }
    }
  }
}

Для варианта с npx README даёт конфиг с "command": "npx" и "args": ["-y", "@chaindead/telegram-mcp"]. Если клиент, например VS Code, не принимает JSON Schema Draft 2020-12, задайте флаг --schema-version с адресом Draft-07.

Проверка

Спросите ассистента: «Какие у меня непрочитанные сообщения в Telegram?». Он должен вызвать tg_dialogs. Если сервер не отвечает, повторите авторизацию и проверьте переменные TG_APP_ID и TG_API_HASH.

Инструменты

Инструмент Что делает Доступ
tg_me Данные текущего аккаунта чтение
tg_dialogs Список диалогов, фильтр по непрочитанным чтение
tg_dialog Сообщения выбранного диалога чтение
tg_read Отметить диалог прочитанным запись
tg_send Сохранить черновик сообщения запись

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

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

Риски

Сервер получает доступ ко всей переписке личного аккаунта Telegram. Сессия хранится локально после авторизации. README предупреждает: нарушение условий Telegram API может привести к блокировке аккаунта.

Как снизить риски: прочитайте условия Telegram API, не передавайте API hash третьим лицам, проверяйте черновики перед отправкой и завершите сессию в настройках Telegram, если перестали пользоваться сервером. Лицензия — MIT.

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

Сервер отправляет сообщения сам?

Нет. По README инструмент tg_send сохраняет черновик в диалоге, отправку делаете вы.

Нужен ли бот в Telegram?

Нет. Сервер работает через Telegram API от имени вашего аккаунта. Нужны API ID и API hash с my.telegram.org.

Работает ли на Windows?

Да. README описывает запуск через npx и бинарники для macOS, Linux и Windows.

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

Инструменты

  • tg_me
  • tg_dialogs
  • tg_dialog
  • tg_read
  • tg_send

Похожие 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

Источники