MK Mailroom

A private command-line tool for indexing one person's own Gmail mailbox.

MK Mailroom is a personal utility. It runs locally on its author's computer and reads a single Gmail account — the author's own — so that correspondence with a small number of known counterparties can be searched offline instead of scrolled through in a browser.

What it does

• Downloads messages matching a narrow, per-counterparty search query.
• Stores them in a local SQLite index with full-text search.
• Extracts PDF attachments (invoices, receipts, tax filings) to local files.

What it does not do

• It has no server, no hosted component and no user accounts.
• It sends no mail. No code path calls messages.send or drafts.send.
• It transmits nothing to the author or to any third party.
• It is not distributed, offered or made available to anyone else.

Access

The tool requests read access to Gmail. Authorization is granted by the account owner through Google's standard consent flow and can be withdrawn at any time at myaccount.google.com/permissions.