Яндекс Почта MCP

gdigora/yandex-mail-mcp· Проверено 12.11.2026· 8на GitHub

Подключает агента к ящику Яндекс Почты по IMAP и SMTP: найти письма, прочитать их с вложениями, отправить, переложить в другую папку или удалить. Вход по паролю приложения.

2 реализации:

Локальный сервер на Python с 7 инструментами, включая скачивание вложений на диск; ставится клонированием репозитория.

Как подключить

Что сделать до подключения

Python 3; склонировать репозиторий, создать виртуальное окружение .venv и выполнить pip install -r requirements.txt

Двухфакторная аутентификация в Яндекс ID: без неё пароль приложения не создать

YANDEX_EMAIL

адрес вашего ящика; можно записать в .env рядом с server.py

YANDEX_APP_PASSWORD

id.yandex.ru → Безопасность → Пароли приложений → новый пароль для «Почты»

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YANDEX_EMAIL=<адрес ящика>' --env 'YANDEX_APP_PASSWORD=<пароль приложения>' --transport stdio yandex-mail \
  -- /path/to/yandex-mail-mcp/.venv/bin/python /path/to/yandex-mail-mcp/server.py

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-mail]
command = "/path/to/yandex-mail-mcp/.venv/bin/python"
args = ["/path/to/yandex-mail-mcp/server.py"]

[mcp_servers.yandex-mail.env]
YANDEX_EMAIL = "<адрес ящика>"
YANDEX_APP_PASSWORD = "<пароль приложения>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-mail": {
      "command": "/path/to/yandex-mail-mcp/.venv/bin/python",
      "args": ["/path/to/yandex-mail-mcp/server.py"],
      "env": {
        "YANDEX_EMAIL": "<адрес ящика>",
        "YANDEX_APP_PASSWORD": "<пароль приложения>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-mail": {
      "type": "stdio",
      "command": "/path/to/yandex-mail-mcp/.venv/bin/python",
      "args": ["/path/to/yandex-mail-mcp/server.py"],
      "env": {
        "YANDEX_EMAIL": "<адрес ящика>",
        "YANDEX_APP_PASSWORD": "<пароль приложения>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-mail": {
      "command": "/path/to/yandex-mail-mcp/.venv/bin/python",
      "args": ["/path/to/yandex-mail-mcp/server.py"],
      "env": {
        "YANDEX_EMAIL": "<адрес ящика>",
        "YANDEX_APP_PASSWORD": "<пароль приложения>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-mail": {
      "command": "/path/to/yandex-mail-mcp/.venv/bin/python",
      "args": ["/path/to/yandex-mail-mcp/server.py"],
      "env": {
        "YANDEX_EMAIL": "<адрес ящика>",
        "YANDEX_APP_PASSWORD": "<пароль приложения>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-mail": {
        "type": "local",
        "command": [
          "/path/to/yandex-mail-mcp/.venv/bin/python",
          "/path/to/yandex-mail-mcp/server.py"
        ],
        "environment": {
          "YANDEX_EMAIL": "<адрес ящика>",
          "YANDEX_APP_PASSWORD": "<пароль приложения>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "yandex-mail": {
      "command": "/path/to/yandex-mail-mcp/.venv/bin/python",
      "args": ["/path/to/yandex-mail-mcp/server.py"],
      "env": {
        "YANDEX_EMAIL": "<адрес ящика>",
        "YANDEX_APP_PASSWORD": "<пароль приложения>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-mail": {
      "command": "/path/to/yandex-mail-mcp/.venv/bin/python",
      "args": ["/path/to/yandex-mail-mcp/server.py"],
      "env": {
        "YANDEX_EMAIL": "<адрес ящика>",
        "YANDEX_APP_PASSWORD": "<пароль приложения>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_foldersперечисляет папки ящика

search_emailsищет письма запросом IMAP

read_emailчитает письмо целиком

download_attachmentсохраняет вложение на диск

send_emailотправляет письмо

move_emailперекладывает в другую папку

delete_emailпереносит письмо в корзину

Удалённый коннектор для ChatGPT на вашем Linux-сервере с OAuth 2.1 и 14 инструментами: ответ с цепочкой, пересылка, черновики, метки.

Как подключить

Что сделать до подключения

Linux-сервер с Python 3.11 или новее и Flask; сервис ставится в /opt/yandex-mail-mcp и запускается через systemd

Домен с действующим сертификатом TLS и обратный прокси nginx, Caddy или Traefik: сервис слушает только 127.0.0.1:5180

Включённый доступ по IMAP: mail.yandex.ru → Настройки → «Доступ по IMAP»

app_password

в config.json: id.yandex.ru/security/apppasswords → «Создать пароль приложения»

access_code

в config.json: любой длинный случайный код, его вводят на экране согласия при подключении

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http yandex-mail-mcp https://<ваш домен>/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-mail-mcp]
url = "https://<ваш домен>/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-mail-mcp": {
      "url": "https://<ваш домен>/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-mail-mcp": {
      "type": "http",
      "url": "https://<ваш домен>/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-mail-mcp": {
      "httpUrl": "https://<ваш домен>/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-mail-mcp": {
      "httpUrl": "https://<ваш домен>/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-mail-mcp": {
        "type": "remote",
        "url": "https://<ваш домен>/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://<ваш домен>/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-mail-mcp": {
      "url": "https://<ваш домен>/mcp"
    }
  }
}

Инструменты сервера

unread_countсчитает непрочитанные

list_foldersперечисляет папки с назначением

search_emailsищет письма запросом IMAP

read_emailчитает письмо и список вложений

send_emailотправляет письмо

reply_emailотвечает с сохранением цепочки

forward_emailпересылает письмо

create_draftсоздаёт черновик

move_emailперекладывает в другую папку

mark_emailставит метки прочитано и важное

delete_emailудаляет в корзину или навсегда

verify_connectionпроверяет IMAP и SMTP

Показано 12 из 14.

Что попросить агента

«Что нового в почте?»Во втором варианте агент вызовет unread_count, в первом — search_emails с запросом UNSEEN

«Найди непрочитанные от <адрес> за последнюю неделю»Агент вызовет search_emails с запросом UNSEEN FROM <адрес> SINCE <дата>

«Подготовь ответ на последнее письмо от <отправитель>: подтверждаю, спасибо»Во втором варианте агент найдёт письмо через search_emails и вызовет create_draft, без отправки

«Перешли последнее письмо о счёте в бухгалтерию <адрес>»Во втором варианте агент вызовет search_emails и forward_email

«Сохрани вложения из письма от <отправитель> в <папка>»В первом варианте агент вызовет search_emails, read_email и download_attachment

Для каких задач

Найти непрочитанные письма от отправителя за последнюю неделю

Пересказать последнее письмо от банка или бухгалтерии

Подготовить ответ черновиком, не отправляя

Отправить письмо с копией и скрытой копией, в том числе в HTML

Скачать вложение из письма на диск

Разложить рассылки по папкам или отправить в корзину

Ограничения

Вход только по паролю приложения: OAuth-доступа к IMAP и SMTP личной Яндекс Почты у Яндекса нет

Агент отправляет письма от вашего имени; delete_email во втором варианте требует confirm: true, а с expunge: true стирает письмо навсегда

Коннектор dreamcatchered требует своего сервера, домена с сертификатом и обратного прокси; рассчитан на ChatGPT

Если не работает

Что-то не работает во втором варианте, ошибка непонятна

Вызовите verify_connection: он проверяет IMAP и SMTP и показывает счётчики.

Коннектор не подключается к ChatGPT за CDN или WAF

Защита может отсекать небраузерные запросы по User-Agent. Добавьте исключение для адреса коннектора.

После смены пароля приложения письма не читаются

Обновите app_password в config.json и перезапустите сервис: systemctl restart yandex-mail-mcp.

Письмо не находится по старому id после перемещения

Во втором варианте id вида папка|uid меняется при перемещении. Найдите письмо заново через search_emails.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Yandex Mail MCP Server	gdigora	8	локально	токен	7	22 декабря 2025
yandex-mail-mcp	dreamcatchered	1	HTTP	вход	14	26 сентября 2026

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

Где взять пароль приложения?

В Яндекс ID: Безопасность → Пароли приложений, создайте пароль для «Почты». Для первого варианта нужна включённая двухфакторная аутентификация. Пароль приложения не открывает веб-интерфейс и отзывается там же.

Как искать письма?

search_emails принимает запрос IMAP: ALL, UNSEEN, FROM sender@example.com, SUBJECT hello, SINCE 01-Dec-2024, можно сочетать. Кириллица в поиске работает в обоих вариантах.

Можно подключить к Claude или Cursor?

Первый вариант работает через stdio с любым клиентом. Второй собран как коннектор ChatGPT: подключение в Settings → Connectors → Create с адресом https://<ваш домен>/mcp и типом Auth OAuth.

Почему первый запрос ко второму варианту долгий?

Яндекс отвечает на новое IMAP-соединение с задержкой до 30 секунд после серии подключений. Сервер держит одно соединение, поэтому медленным бывает только первый вызов после запуска.

Работает ли сервер из России?

Оба сервера ходят в Яндекс Почту по IMAP и SMTP с вашим паролем приложения; первый запускается на вашем компьютере, второй — на вашем сервере.

Яндекс Почта MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

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