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