Repository navigation
v0.3.3
Added
settings.toolset("full"default,"core","minimal"; envMCP_EMAIL_TOOLSET) sends the model a shorter tool list: 8 tools in minimal, 21 in core. Prompts and resources stay in every toolset. Grouping idea from Mailoo by Bitfloo.export_emailsaves a message's raw source as a.emlfile (or returns it inline up to 5 MB). Reads withBODY.PEEK, so it never marks mail read. Tool shape from Mailoo by Bitfloo.- Output schemas and structured results for
get_email,get_emails,get_threadandlist_accounts, so clients that generate typed tool libraries ("code mode") work better. - Releases publish themselves: pushing a version tag runs
.github/workflows/release.yml, which publishes to npm (trusted publishing with provenance), the MCP Registry, a multi-arch Docker image atghcr.io/fe2-o3/imap-wizard, and the GitHub release.
Security
- Email text in tool output (
get_email,get_emails,get_thread, list and search previews) is wrapped in untrusted-content markers so a message cannot pass itself off as instructions. Structured results stay raw. Adapted from Mailoo by Bitfloo. download_attachment'ssavePathno longer overwrites existing files or accepts relative paths. Saved files (attachments, exports,saveEmailAttachments) are refused in system folders, hidden folders, the home folder root and this app's own folders, including through symlinks. Path guard adapted from Mailoo by Bitfloo.delete_mailboxandrename_mailboxrefuse INBOX and special-use folders (Sent, Drafts, Trash, Junk, Archive). Adapted from Mailoo by Bitfloo.- Tool annotations are honest:
download_attachmentandexport_email(write local files) andget_emailwithmarkReadare no longer marked read-only. They remain available in read-only mode as before.
Fixed
- Waiting for a mailbox lock is bounded at 60 seconds; a stuck connection is closed and redialled instead of freezing later calls. Adapted from Mailoo by Bitfloo.
- Read-only mode now closes IMAP connections and the cache on shutdown, like write mode.
Changed
- Node.js 22.13 or newer is supported (was 24+).
- Removed the unused GoReleaser configuration.
Docs
docs/dev/sieve-plan.md: plan for server-side filter rules (Sieve), including which providers support it.
Install: npx -y imap-wizard, or docker pull ghcr.io/fe2-o3/imap-wizard:v0.3.3