Better Telegram MCP — MCP-сервер для Claude Code: доступ к Telegram
Даёт агенту доступ к Telegram: сообщения, чаты, медиа и контакты. Работает и от бота, и от обычного аккаунта.
claude mcp add --env TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> --env TELEGRAM_API_ID=<TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<TELEGRAM_API_HASH> --transport stdio better-telegram-mcp -- uvx better-telegram-mcpЧто делает Better Telegram MCP
Сервер действует в двух режимах. Если задан токен бота, запросы идут через Bot API на httpx. Если вместо токена указаны API-ключи аккаунта, включается MTProto на Telethon — тогда агенту доступен обычный пользовательский аккаунт, а не только бот.
Внутри семь инструментов с диспетчеризацией по действию: message, chat, media, contact, config, help и config__open_relay. Часть из них помечена как read-only, часть — как разрушительная, так что агенту есть на что опереться при выборе. Справка отдаётся ещё и MCP-ресурсами по схеме telegram://docs/*.
Для пользовательского аккаунта вход устроен через браузер: в HTTP-режиме форма принимает телефон, OTP и пароль двухфакторной аутентификации. На одной машине то же самое делает auth в CLI, login остался устаревшим псевдонимом. Без токена бота или пары API ID и hash сервер не поймёт, от чьего имени работать. Локально исполняемый файл по умолчанию поднимается на stdio, а HTTP включается флагами --http, MCP_TRANSPORT=http или TRANSPORT_MODE=http.
Какие задачи решает
- Отправить сообщение в чат прямо из сессии агента
- Скачать медиа из переписки и передать его в проект
- Пройтись по списку контактов и найти нужного человека
- Разобрать входящие сообщения и разложить по задачам
- Завести бота и аккаунт под одним интерфейсом
Примеры запросов агенту
- Отправь в чат
dev-teamсообщение о том, что сборка упала - Найди в контактах Ивана и покажи последние сообщения с ним
- Скачай последнее фото из чата
release
Как установить Better Telegram MCP
Командой платформы
claude mcp add --env TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> --env TELEGRAM_API_ID=<TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<TELEGRAM_API_HASH> --transport stdio better-telegram-mcp -- uvx better-telegram-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from better-telegram-mcp <команда>
Командой платформы
codex mcp add better-telegram-mcp --env TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> --env TELEGRAM_API_ID=<TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<TELEGRAM_API_HASH> -- uvx better-telegram-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from better-telegram-mcp <команда>
Файл настроек
{
"mcpServers": {
"better-telegram-mcp": {
"command": "uvx",
"args": [
"better-telegram-mcp"
],
"env": {
"TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>",
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from better-telegram-mcp <команда>
Файл настроек
{
"servers": {
"better-telegram-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"better-telegram-mcp"
],
"env": {
"TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>",
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from better-telegram-mcp <команда>
Командой платформы
gemini mcp add -e TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> -e TELEGRAM_API_ID=<TELEGRAM_API_ID> -e TELEGRAM_API_HASH=<TELEGRAM_API_HASH> better-telegram-mcp uvx better-telegram-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from better-telegram-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Better Telegram MCP
Как установить Better Telegram MCP в Claude Code?
Через CLI: claude mcp add better-telegram-mcp -e TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> -e TELEGRAM_API_HASH=<TELEGRAM_API_HASH> -- uvx better-telegram-mcp. Для пользовательского аккаунта есть второй вариант — с TELEGRAM_API_ID и --transport stdio.
Что делает Better Telegram MCP?
Соединяет агента с Telegram: отправляет сообщения, читает чаты, работает с медиа и контактами. Режим зависит от того, что вы указали — токен бота или ключи аккаунта.
Что нужно, чтобы работать от обычного аккаунта?
TELEGRAM_API_ID, TELEGRAM_API_HASH и вход по номеру телефона. В HTTP-режиме код подтверждения и пароль 2FA вводятся в браузерной форме.
