Skip to content

v0.3.0 — published to npm as imap-wizard

Choose a tag to compare

@Fe2-O3 Fe2-O3 released this 17 Nov 21:10
· 78 commits to main since this release

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, one UID 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 same assembleEmail(). Schema v2 adds the message_body table; bodies over 256 KB are skipped rather than truncated, and a decoder version invalidates stale rows.
  • Offline reads (offline_reads, default on when read_through is 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 past body_max_mb, and the max_size_mb backstop evicts bodies before pruning message rows.

Fixed

  • FTS reindex on flag-only resyncs — the message_fts_update trigger 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 is imap-wizard and the command is imap-wizard, replacing email-mcp. The install wizard's npx, pnpm dlx and 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-mcp and friends), the keychain entries, the EMAIL_MCP_* environment variables and the email key written into MCP client configs are unchanged, so existing setups keep working.
  • Idle exit now defaults to off — settings.idle_exit default 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> or MCP_EMAIL_IDLE_EXIT). New configs and the config template ship idle_exit = 0.
  • Provider-aware outbound attachment caps — settings.send.max_attachment_mb defaults to 25 MB; known provider limits can lower it, and an account-level max_attachment_mb can override it. The cap is checked before SMTP send, including inline and forwarded/draft attachments.
  • Opt-in verification lookup — get_verification_code is registered only when settings.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)