Skip to content

3.0.0 — Server drafts and keyword search

Choose a tag to compare

@1amSheldon 1amSheldon released this 21 Sep 13:23
· 113 commits to main since this release
587f09f

Server drafts and keyword search

  • Edit IMAP drafts with updateDraft and send the latest server revision with sendDraft. 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-local when 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.