Repository navigation
3.0.0 — Server drafts and keyword search
Server drafts and keyword search
- Edit IMAP drafts with
updateDraftand send the latest server revision withsendDraft. Stable local draft IDs follow supported webmail UID changes. - Persist delivery attempts across restarts. Repeated calls return the saved result; uncertain or partial delivery never triggers an automatic resend. Retain the source draft unless all recipients were accepted and a Sent copy was confirmed.
- Preserve MIME bodies, attachments, threading, and custom draft metadata. Reject ambiguous routing headers and strip Bcc from the wire while retaining envelope recipients.
- Search with
keywordsAll,keywordsAny,excludeKeywords, body/subject/all scopes, unread/read and flagged/unflagged filters. Searches stay server-side and bind all filters to their pagination cursor. - Recognize provider-prefixed Message-IDs during Sent verification without scanning unrelated recent messages.
- Install a local Windows checkout with
--install-codex-localwhen developing. Published installations keep the windowless direct-Node supervisor and npm updates. - Keep the compact three-tool MCP interface; detailed instructions remain available on demand for Codex and Claude.
Upgrade
Accounts, credentials, and HTTP connection settings remain in place. Refresh the MCP client's tool catalog to discover the new draft operations. Draft state is stored under ~/.config/mail-mcp/draft-state; preserve it when moving an installation. Independent sends from webmail or another computer are outside local duplicate prevention. Interrupted draft replacement or stale process locks require inspection rather than an automatic retry.
Verification
npm run release:check includes unit tests, loopback SMTP integration, build, English-only text, stdio/HTTP/import smoke checks, and dependency audit. The loopback test verifies actual MIME delivery, hidden Bcc, attachment preservation, and no duplicate after a restart. A read-only probe against a configured IMAP account verified positive keyword matches, exclusions, and combined text/flag criteria; it did not modify mail or print message contents. Credential-gated provider IMAP integration cases remain skipped when test credentials are absent. Live draft writes and sends were not performed on the user's mailbox.
Thanks to wiederholung for the initial draft workflow contribution. This release adds persistence, MIME, validation, and regression-test fixes after review.