Claude Yandex Mail

claude-yandex-mail

[](https://github.com/nikarmontag-cmd/claude-yandex-mail/actions/workflows/lint.yml) [](LICENSE) [](https://www.python.org/downloads/)

Плагин для Claude Code и Claude Cowork, превращающий Claude в почтового ассистента для Яндекс.Почты (включая Яндекс 360 для бизнеса с собственными доменами).

A plugin for Claude Code and Claude Cowork that turns Claude into a mail assistant for Yandex Mail (including Yandex 360 for Business with custom domains).

---

Demo

You: проверь почту

Claude:
Непрочитанных: 5

🔴 NEEDS REPLY (2):
  • [UID 1234] From Иванов И.И.  · business
    Запрос КП на отопление склада 800 м². Просит ответ до пятницы.
  • [UID 1233] From accounting@bank.example · financial
    Подтверждение платежа ожидает вашего согласия (дедлайн сегодня).

🟡 SHOULD READ (1):
  • [UID 1232] From notifications@stripe.com · notification
    Получен платёж $1,250.00 от ООО Партнёр.

⚪️ CAN IGNORE (2):
  • LinkedIn — еженедельная сводка
  • GitHub — Dependabot alert summary

Recommendation: ответь Иванову первым — дедлайн в пятницу.

You: ответь Иванову, что КП пришлю в среду
Claude: [показывает черновик с подписью и логотипом]
        Отправить?
You: да
Claude: ✓ Ответ отправлен на i.ivanov@example.com (тема: Re: Запрос КП ...)

Architecture

sequenceDiagram
    participant U as User
    participant C as Claude (Code/Cowork)
    participant S as check-inbox skill
    participant M as MCP server (server.py)
    participant Y as Yandex IMAP/SMTP

    U->>C: "проверь почту"
    C->>S: skill match
    S->>M: get_unread_emails(limit=10)
    M->>Y: UID SEARCH UNSEENUID FETCH BODY.PEEK[]
    Y-->>M: raw RFC822 messages
    M-->>S: parsed (decoded subject, body, from)
    S->>C: categorise + prioritise
    C-->>U: structured triage

---

🇷🇺 Русский

Что внутри

| Компонент | Что делает | |---|---| | MCP-сервер yandex-mail | 11 асинхронных инструментов через IMAP/SMTP: отправка с HTML-подписью и inline-картинками, поиск, листинг папок, перемещение между папками, метки прочитанности, ответы с цитированием | | Скилл check-inbox | Триаж непрочитанных: категории (business / project / financial / personal / notification / marketing) и срочность (🔴/🟡/⚪️) | | Скилл compose-email | Новое деловое письмо с HTML-подписью, логотипом и подтверждением перед отправкой | | Скилл reply-to-email | Поиск оригинала, ответ с цитированием и сохранением thread (Re:, In-Reply-To, References) |

Триггеры

| Скажи Claude | Скилл | |---|---| | «проверь почту», «что нового», «покажи непрочитанные» | check-inbox | | «напиши письмо X», «отправь письмо», «составь письмо» | compose-email | | «ответь X», «ответь на последнее письмо от X» | reply-to-email |

Установка

1. Получи пароль приложения Яндекса

Это не обычный пароль аккаунта. Получить:

1. Включи двухфакторную аутентификацию на id.yandex.ru
2. Открой https://id.yandex.ru/security/app-passwords
3. Создай пароль типа «Почта» — Яндекс покажет 16-символьный пароль один раз
4. Дополнительно: в настройках Яндекс.Почты убедись, что включён доступ по IMAP (Все настройки → Почтовые программы → ☑ С сервера imap.yandex.ru по протоколу IMAP)

2. Клонируй и настрой

git clone https://github.com/nikarmontag-cmd/claude-yandex-mail.git
cd claude-yandex-mail
chmod +x scripts/setup.sh
./scripts/setup.sh

Скрипт спросит email + пароль приложения, создаст venv, установит зависимости и проверит подключение. Затем спросит данные для подписи (имя, должность, компания, email, телефон, сайт, путь к логотипу).

3. Подключи к Claude

Claude Code:

claude plugin add /полный/путь/к/claude-yandex-mail

Claude Cowork: упакуй в .plugin и перетащи в окно приложения:

./scripts/build-plugin.sh ~/Desktop
# Создаст ~/Desktop/claude-yandex-mail.plugin

Затем перетащи .plugin файл в окно Cowork.

После установки — открой /mcp (в Claude Code), убедись что yandex-mail ✓ подключён, и попробуй: «проверь почту».

Требования

• macOS / Linux (Windows не тестировался — должен работать с WSL или MSYS)
• Python 3.10+
• Bash 4+ для setup-скрипта
• Аккаунт Яндекс.Почты с включённой 2FA и паролем приложения

Безопасность

• Креды хранятся в server/.env с chmod 600, файл в .gitignore
• Подпись и логотип в assets/, тоже игнорируются git'ом
• Никакие данные не уходят за пределы Яндекса и твоей машины

Структура

claude-yandex-mail/
├── .claude-plugin/plugin.json    # манифест плагина
├── .mcp.json                     # конфиг MCP-сервера
├── server/
│   ├── server.py                 # MCP-сервер (asyncio + aioimaplib + aiosmtplib)
│   ├── requirements.txt
│   └── .env.example              # шаблон для кредов
├── skills/
│   ├── check-inbox/SKILL.md
│   ├── compose-email/SKILL.md
│   └── reply-to-email/SKILL.md
├── assets/
│   ├── signature.template.html   # шаблон подписи (HTML)
│   ├── signature.template.txt    # шаблон подписи (plain)
│   ├── signature.html            # сгенерируется setup-скриптом
│   ├── signature.txt             # сгенерируется setup-скриптом
│   └── logo.jpg                  # опционально, скопируется setup-скриптом
├── scripts/setup.sh
├── LICENSE
└── README.md

Изменить подпись

Удали assets/signature.html и assets/signature.txt, перезапусти ./scripts/setup.sh.

Или отредактируй файлы вручную — они в обычном HTML/тексте, без шаблонизации.

Лицензия

MIT — см. [LICENSE](LICENSE).

---

🇬🇧 English

What's inside

| Component | Purpose | |---|---| | MCP server yandex-mail | 11 async tools over IMAP/SMTP: send with HTML signature and inline images, search, list folders, move between folders, set/unset read flags, threaded replies | | Skill check-inbox | Triage unread mail: categorise (business / project / financial / personal / notification / marketing) and rank by urgency (🔴/🟡/⚪️) | | Skill compose-email | Compose a new business email with HTML signature, optional logo, and explicit send confirmation | | Skill reply-to-email | Find the original message, reply with quoting and proper threading (Re:, In-Reply-To, References) |

Triggers

| Tell Claude | Skill | |---|---| | "check my mail", "what's new", "show unread" | check-inbox | | "write an email to X", "send X a message", "compose an email" | compose-email | | "reply to X", "reply to the last email from X" | reply-to-email |

Installation

1. Get a Yandex app password

This is not your normal account password. To get one:

1. Enable 2FA on id.yandex.com
2. Open https://id.yandex.com/security/app-passwords
3. Create a "Mail" app password — Yandex shows the 16-char password exactly once
4. In Yandex Mail settings, make sure IMAP access is enabled (All settings → Mail clients → ☑ From imap.yandex.com via IMAP)

2. Clone and set up

git clone https://github.com/nikarmontag-cmd/claude-yandex-mail.git
cd claude-yandex-mail
chmod +x scripts/setup.sh
./scripts/setup.sh

The script asks for your email + app password, creates a venv, installs dependencies, and tests the IMAP connection. It then asks for signature details (name, position, company, email, phone, website, optional logo path).

3. Connect to Claude

Claude Code:

claude plugin add /full/path/to/claude-yandex-mail

Claude Cowork: package as .plugin and drop into the app:

./scripts/build-plugin.sh ~/Desktop
# Creates ~/Desktop/claude-yandex-mail.plugin

Then drag the .plugin file into Cowork.

After install, open /mcp (in Claude Code), confirm yandex-mail is ✓ connected, and try: "check my mail".

Requirements

• macOS / Linux (Windows not tested — should work via WSL or MSYS)
• Python 3.10+
• Bash 4+ for the setup script
• A Yandex Mail account with 2FA enabled and an app password

Security

• Credentials are stored in server/.env with chmod 600, gitignored
• Signature and logo live in assets/, also gitignored
• Nothing leaves Yandex and your local machine

Layout

See the structure tree in the Russian section above.

Changing the signature

Delete assets/signature.html and assets/signature.txt, then re-run ./scripts/setup.sh.

Or edit the files manually — they're plain HTML/text, no templating after generation.

License

MIT — see [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: nikarmontag-cmd
• Source: nikarmontag-cmd/claude-yandex-mail
• License: MIT
• Homepage: https://github.com/nikarmontag-cmd/claude-yandex-mail

Install and usage instructions live in the source repository linked above.