Repository navigation
v0.3.0 — published to npm as imap-wizard
First npm release of this fork. 0.2.x is skipped because tags v0.2.0–v0.2.3
from the original project's history already exist in this repository.
Added
- Body cache for
get_email(opt-in,settings.cache.read_through, default off) — a message's body, headers and structure are immutable per (UIDVALIDITY, UID), so a repeat read costs a mailbox lock, oneUID FETCH (UID FLAGS)and a local read; flags stay live and a moved or deleted message still reports not found. Live and cached reads build the result with the sameassembleEmail(). Schema v2 adds themessage_bodytable; bodies over 256 KB are skipped rather than truncated, and a decoder version invalidates stale rows. - Offline reads (
offline_reads, default on whenread_throughis on) — when the server is unreachable, an already-cached message is returned with a visible warning. Only genuine connectivity errors qualify; auth failures and not-found are never served from cache. - Bounded body backfill and budget (
body_messages,body_max_mb) — the newest mirrored messages are cached in the background one mailbox lock per message; cached bodies are LRU-evicted pastbody_max_mb, and themax_size_mbbackstop evicts bodies before pruning message rows.
Fixed
- FTS reindex on flag-only resyncs — the
message_fts_updatetrigger fired on every update, rewriting the index for subject, sender and body on each flag change; it now fires only when an indexed column's value changes (migrated automatically on first open). - Mirror rows keyed by the sanitized mailbox name, matching how reads look them up.
Changed
- BREAKING: renamed to
imap-wizard. The npm package isimap-wizardand the command isimap-wizard, replacingemail-mcp. Theinstallwizard'snpx,pnpm dlxand global options no longer launch upstream's@codefuturist/email-mcp; smithery.yaml and server.json point at this fork too. The config, data and cache directories (~/.config/email-mcpand friends), the keychain entries, theEMAIL_MCP_*environment variables and theemailkey written into MCP client configs are unchanged, so existing setups keep working. - Idle exit now defaults to off —
settings.idle_exitdefault 1800 s → 0. The client closing stdin remains the primary exit signal, so a clean Claude/OpenCode quit still ends the server immediately; the timer is now an opt-in backstop (idle_exit = <seconds>orMCP_EMAIL_IDLE_EXIT). New configs and the config template shipidle_exit = 0. - Provider-aware outbound attachment caps —
settings.send.max_attachment_mbdefaults to 25 MB; known provider limits can lower it, and an account-levelmax_attachment_mbcan override it. The cap is checked before SMTP send, including inline and forwarded/draft attachments. - Opt-in verification lookup —
get_verification_codeis registered only whensettings.verification.enabled = true. It scans recent mail only on request; optional magic-link lookup and clipboard writes are off unless explicitly enabled/requested. The clipboard is never read or cleared, and writes are blocked in read-only mode and limited to 10 per minute. - Email terminal CLI — list, read, search, mailboxes, flag, delete, attachment download, reply, and send commands reuse the IMAP/SMTP services and enforce read-only and attachment-size limits.
Install: npx -y imap-wizard (npm: https://www.npmjs.com/package/imap-wizard)