Claude Yandex Mail

lint License: MIT Python 3.10+

Плагин для 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 Иванов И.И. <[email protected]> · business
    Запрос КП на отопление склада 800 м². Просит ответ до пятницы.
  • [UID 1233] From [email protected] · financial
    Подтверждение платежа ожидает вашего согласия (дедлайн сегодня).

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

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

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

You: ответь Иванову, что КП пришлю в среду
Claude: [показывает черновик с подписью и логотипом]
        Отправить?
You: да
Claude: ✓ Ответ отправлен на [email protected] (тема: 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 UNSEEN<br/>UID 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.

---

🇬🇧 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.