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` создаёт черновики — проверяйте их перед отправкой.
Настройка клиентов
{
"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 или новее.
Авторизация
- Получите API ID и API hash на странице my.telegram.org.
- Выполните вход и введите код, который пришлёт 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.
{
"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.
PraisonAI
Фреймворк агентов PraisonAI с саморефлексией и поддержкой MCP.
mcp-atlassian
Поиск, чтение, создание и управление контентом Confluence и Jira, включая Server и Data Center.
Jitsu
Управление пайплайнами данных Jitsu: направления, потоки, подключения и функции.