MailDump

MailDump

IMAP mail → clean Markdown digest → structured analysis inside Obsidian.

MailDump is a desktop-only Obsidian plugin for exporting email from IMAP folders into analysis-ready Markdown.

It is built for people who do not need another pretty mailbox. They need a controlled source package: messages, metadata, threads, contacts, unanswered items, attachments when necessary, and a format that can be read by humans, Obsidian, Dataview, scripts, or an LLM.

No CSV graveyard. No fake AI magic. No black-box sync. Just mail pulled into a vault in a form that can be inspected, reused, archived and analyzed.

---

What MailDump is for

MailDump turns selected IMAP folders into a Markdown digest for operational analysis.

Typical use cases:

• collect project correspondence for a day, week or custom period;
• prepare raw material for management summaries;
• identify subject-based email threads;
• find incoming messages that may still need a reply;
• preserve message metadata for later verification;
• export post-meeting or post-action emails as separate Markdown notes;
• save selected attachment types next to the corresponding mail note.

MailDump is not an email client. It does not replace your mailbox. It extracts the part of the mailbox that matters for analysis and puts it where the work actually happens: in Markdown.

---

Core features

---

What the digest contains

A generated digest includes:

1. Run parameters.
2. Technical counters.
3. Active filters.
4. Subject-based thread index.
5. Key contacts.
6. Potentially unanswered incoming messages.
7. Full message list with YAML metadata and message body.

For each message, MailDump can include:

uid: "12345"
mailbox: "INBOX"
direction: "incoming"
date: "2026-05-16 18:42:10"
from: "Sender <[email protected]>"
to: "User <[email protected]>"
cc: "Copy <[email protected]>"
subject: "Project status"
normalized_subject: "project status"
message_id: "<[email protected]>"
in_reply_to: "<[email protected]>"
references: "<[email protected]>"
thread_key: "subject-based-key"
reference_thread_key: "reference-based-key"
has_attachments: true
attachments_count: 2
unanswered_over_threshold: false
body_length: 1842

The body is stored below the YAML block as regular Markdown text.

---

Installation

Manual installation

1. Open your Obsidian vault folder.
2. Create the plugin folder:

.obsidian/plugins/maildump/

3. Copy these files into the folder:

main.js
manifest.json
styles.css

4. Restart Obsidian.
5. Open Settings → Community plugins.
6. Enable MailDump.

Community Plugins

After publication in the Obsidian Community Plugins directory, MailDump will be installable through the standard Obsidian plugin browser.

Until then, use manual installation.

---

Opening the panel

Use the ribbon icon or run the command:

Open MailDump panel

Command names are in English for Obsidian compatibility. The plugin interface is in Russian.

---

Basic setup

Open MailDump settings and configure:

Use an app-password from your mail provider. Do not use the main account password unless you enjoy turning simple tools into security incidents.

---

App-password modes

MailDump supports three app-password modes:

MailDump does not intentionally write the app-password to logs, digests or exported preset files.

Never publish:

data.json
_mail_dump_runs.json
MailDump/

---

Presets

Presets define repeatable export scenarios:

• period;
• IMAP folders;
• output name;
• filters;
• digest fields;
• reply-chain cleanup;
• message note export;
• attachment export rules;
• sorting.

Presets are stored in Obsidian plugin data.json, not in a working presets.json file.

The panel provides separate buttons for:

• saving the current preset;
• importing presets from JSON;
• exporting presets to JSON.

Exported preset files are written into the configured MailDump output folder.

---

Export flow

1. Open the MailDump panel.
2. Configure IMAP settings.
3. Load the IMAP folder list.
4. Select folders for the current preset.
5. Choose or create a preset.
6. Select the period.
7. Configure filters and digest content.
8. Press ▶ Пуск.
9. Open the generated Markdown digest in the output folder.

Default output folder:

MailDump/

---

Filters

MailDump supports include and exclude filters for:

• sender;
• recipient / copy;
• subject.

Filters are applied locally after messages for the selected period are loaded.

This is intentional. IMAP search with Cyrillic subjects is not reliable across mail providers. Predictable local filtering is better than elegant server-side filtering that silently misses messages. Elegant failure is still failure, only with nicer shoes.

---

Reply-chain cleanup

MailDump can clean message bodies before writing them into the digest.

Available options:

• remove reply chains;
• remove signatures;
• keep forwarded messages;
• use a manual reply-chain marker;
• keep original body without cleanup.

A custom marker is useful when corporate mail templates use stable separators, for example:

----------------
Кому:

When the marker is found, MailDump cuts everything below it.

---

Message notes and attachments

By default, MailDump creates one digest file.

For special scenarios, such as post-meeting mail packages, a preset can also create separate Markdown notes for messages.

If attachment export is enabled, selected attachment extensions are saved next to the corresponding message note. The message note and its attachments share the same timestamp / UID prefix.

Example:

MailDump/Postmits/2026-05-16/
├─ 2026-05-16_18-42-10_12916_Project_status.md
├─ 2026-05-16_18-42-10_12916_minutes.pdf
└─ 2026-05-16_18-42-10_12916_table.xlsx

Supported extensions are configured in the preset UI.

---

Limitations

MailDump deliberately has boundaries:

• desktop Obsidian only;
• no Obsidian mobile support;
• no AI summary generation;
• no delta synchronization;
• no CSV export;
• no background daemon;
• no mailbox editing;
• no sending mail;
• no server-side deletion;
• no deep rewrite of the IMAP/MIME engine in this release.

Current IMAP/MIME processing is built into the plugin and kept intentionally conservative for the first public architecture release.

---

Privacy and security

MailDump connects from the local Obsidian desktop app to the configured IMAP server.

It writes output files into your vault. It does not send exported mail to third-party services.

Still, the generated digest can contain sensitive correspondence. Treat the output folder as confidential project material.

Do not commit these files:

data.json
_mail_dump_runs.json
MailDump/

The included .gitignore is there for a reason. A small reason, admittedly, but the kind that prevents large embarrassment.

---

Versioning

Public versioning starts from:

0.0.1

This release is the first public architecture baseline. It is intended to make the plugin clean enough for a public repository and further Community Plugins preparation.

Recommended version policy:

---

License

MIT.

---

MailDump — русский раздел

Почта из IMAP → чистый Markdown → управляемая сводка в Obsidian.

MailDump — desktop-only плагин для Obsidian. Он выгружает письма из IMAP-папок и собирает из них Markdown-пакет для анализа.

Не почтовый клиент. Не очередная красивая панелька ради панельки. Не «ИИ сейчас всё сам поймёт», потому что эта сказка обычно заканчивается потерянной задачей и виноватым РП.

MailDump делает более приземлённую вещь: забирает письма, сохраняет метаданные, собирает цепочки, показывает потенциально оставшиеся без ответа входящие и кладёт всё в Markdown.

---

Для чего это нужно

MailDump нужен, когда почта становится не перепиской, а источником управленческих фактов.

Типовые сценарии:

• собрать почту за день, неделю или произвольный период;
• подготовить сырьё для управленческой сводки;
• разобрать проектную переписку по темам;
• найти входящие, которые могли остаться без ответа;
• сохранить доказуемые метаданные письма;
• выгрузить постмиты отдельными Markdown-файлами;
• положить вложения рядом с конкретным письмом;
• передать digest дальше в ручной или AI-анализ.

Главная идея простая: письмо должно стать нормальным проектным источником, а не утонуть в ящике между рекламой, пересылками и корпоративным фольклором.

---

Что умеет

---

Что попадает в digest

Digest содержит:

1. Параметры запуска.
2. Технические счётчики.
3. Фильтры.
4. Индекс цепочек по теме.
5. Ключевые контакты.
6. Потенциально оставшиеся без ответа входящие.
7. Список писем с YAML-метаданными и телом письма.

Пример блока письма:

uid: "12345"
mailbox: "INBOX"
direction: "incoming"
date: "2026-05-16 18:42:10"
from: "Иванов Иван <[email protected]>"
to: "Петров Петр <[email protected]>"
cc: "Сидоров <[email protected]>"
subject: "Статус по проекту"
normalized_subject: "статус по проекту"
message_id: "<[email protected]>"
in_reply_to: "<[email protected]>"
references: "<[email protected]>"
thread_key: "subject-based-key"
reference_thread_key: "reference-based-key"
has_attachments: true
attachments_count: 2
unanswered_over_threshold: false
body_length: 1842

Ниже идёт тело письма обычным Markdown-текстом.

---

Установка вручную

Создать папку:

.obsidian/plugins/maildump/

Скопировать туда:

main.js
manifest.json
styles.css

Потом:

1. Перезапустить Obsidian.
2. Открыть Settings → Community plugins.
3. Включить MailDump.

После публикации в Community Plugins установка будет идти через стандартный каталог Obsidian.

---

Как открыть

Через ribbon icon или команду Obsidian:

Open MailDump panel

Команды Obsidian на английском. Интерфейс панели на русском. Это не раздвоение личности, а нормальная совместимость с каталогом и хоткеями.

---

Настройка

В настройках плагина указать:

Использовать лучше app-password почтового сервиса, а не основной пароль аккаунта.

---

Хранение app-password

Доступны три режима:

MailDump не должен писать app-password в логи, digest или экспортированные пресеты.

Не публиковать:

data.json
_mail_dump_runs.json
MailDump/

---

Пресеты

Пресет — это сохранённый сценарий выгрузки:

• период;
• IMAP-папки;
• имя digest;
• фильтры;
• состав полей;
• очистка цепочек;
• создание отдельных .md писем;
• сохранение вложений;
• сортировка.

Рабочее хранение пресетов идёт через data.json. Внешний presets.json не является рабочим хранилищем.

В панели есть отдельные кнопки:

• сохранить текущий пресет;
• импортировать пресеты из JSON;
• экспортировать пресеты в JSON.

---

Запуск выгрузки

Порядок работы:

1. Открыть панель MailDump.
2. Заполнить настройки IMAP.
3. Загрузить список папок.
4. Выбрать папки в текущем пресете.
5. Выбрать или создать пресет.
6. Задать период.
7. Настроить фильтры и состав digest.
8. Нажать ▶ Пуск.
9. Открыть созданный .md файл в папке выгрузки.

Папка по умолчанию:

MailDump/

---

Фильтры

Фильтры есть по трём полям:

• отправитель;
• кому / копия;
• тема.

Фильтры применяются локально после загрузки писем за период.

Это сделано намеренно: IMAP-поиск по русским темам у разных серверов ведёт себя нестабильно. Лучше загрузить период и отфильтровать предсказуемо, чем красиво не найти половину писем.

---

Очистка цепочек

MailDump может чистить тело письма перед записью в digest:

• удалять старую переписку;
• удалять подписи;
• сохранять пересылаемые письма;
• использовать ручной маркер начала цепочки;
• оставлять исходный текст без очистки.

Пример ручного маркера:

----------------
Кому:

Если маркер найден, всё ниже него вырезается.

---

Файлы писем и вложения

По умолчанию создаётся один digest.

Для постмитов и похожих сценариев можно включить создание отдельных .md файлов писем. Тогда вложения выбранных типов сохраняются рядом с письмом.

Пример:

MailDump/Postmits/2026-05-16/
├─ 2026-05-16_18-42-10_12916_Статус_по_проекту.md
├─ 2026-05-16_18-42-10_12916_протокол.pdf
└─ 2026-05-16_18-42-10_12916_таблица.xlsx

У письма и вложений общий префикс по дате, времени и UID. Потом можно понять, что к чему относится, не устраивая археологическую экспедицию по папкам.

---

Ограничения

В этой версии MailDump не делает:

• мобильную поддержку;
• AI-сводку;
• delta-синхронизацию;
• CSV;
• отправку писем;
• редактирование ящика;
• удаление писем на сервере;
• фоновый демон;
• глубокую переделку IMAP/MIME-движка.

Это сознательная граница версии 0.0.1: сначала чистая публичная база, потом расширение функциональности.

---

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

MailDump подключается к IMAP напрямую из локального Obsidian desktop.

Плагин не отправляет выгруженную почту во внешние сервисы. Но сам digest может содержать чувствительную переписку, поэтому папка выгрузки должна считаться рабочим конфиденциальным материалом.

Не добавлять в Git:

data.json
_mail_dump_runs.json
MailDump/

.gitignore добавлен не для красоты. Хотя красота там тоже спорная, как и у любого файла, который существует ради предотвращения человеческих ошибок.

---

Версионирование

Публичная история начинается с:

0.0.1

Это первая публичная архитектурная база. Не финальная «мы всё придумали навсегда», а аккуратный старт для репозитория и подготовки к Community Plugins.

Логика версий:

---

Лицензия

MIT.