Repository navigation
Releases
v0.3.5
🐛 Bug Fixes
- (ci) run pre-push checks for tag-only pushes (#103) - (928759b), (1dab6d2) - Mike, Codex
- make first-use mailbox flows reliable (#105) - (ad72d0a), (64af065) - Mike, Codex
- retain sent copies on fresh mail accounts - (08b46cd), (06bda10) - Mike, Codex
- verify packaged mail workflows before release - (bc5b712), (10f6958) - Mike, Codex
📚 Documentation
- recommend read-only first connections - (fee30eb) - Mike, Codex
- align guided setup with read-only first use - (01e249b) - Mike, Codex
- guide first-run email connections (#104) - (3b9fdc5), (ae9cd0a) - Mike, Codex
- retain toolset catalog text in architecture diagram - (418ffab) - Mike, Codex
- clarify saving after failed connection checks - (1bab909) - Mike, Codex
Install: npx -y @bitfloo/mailoo@latest · docker pull ghcr.io/bitfloo/mailoo:0.3.5 (or 0.3.5-alpine)
Full history: CHANGELOG.md
v0.3.4
✨ Features
- add opt-in install count (#79) - (3ddb6d2) - Mike
- count one install when two servers start at once - (0dd0019) - Mike, Claude Opus 5.5
- count an opted-in server start without sending mail data - (7b879d8) - Mike, Cursor, Claude Opus 5.5
🐛 Bug Fixes
- (audit) avoid traversing proxy prototypes during type checks - (1d9aeae) - Mike, Codex
- (audit) avoid executing code while redacting params - (3577cd9) - Mike, Codex
- (build) align package manager pins and CLI lockfiles - (fb5bcee) - Mike, Codex
- (build) declare the release tooling package manager - (c0fe374) - Mike, Codex
- (cli) probe the account settings saved by the wizard - (fdfc71c) - Mike, Codex
- (deps) update vulnerable server and archive dependencies - (260b4ea) - Mike, Codex
- (sieve) bound response bytes and total protocol waits - (f32da41) - Mike, Codex
- (sieve) bound connection waits and preserve protocol bytes - (b93e95f) - Mike, Codex
- write only the documented install count marker digit - (1ea746d) - Mike, Codex
- refuse an install count URL with a query or fragment - (b7c3b15) - Mike, Claude Opus 5.5
- claim the install count before sending so a state directory counts once - (d88c344) - Mike, Claude Opus 5.5
📚 Documentation
- launch the install count example at latest - (26f4bc7) - Mike, Codex
- say the install count switch ignores letter case and spaces - (65abb3b) - Mike, Claude Opus 5.5
- say a blank CI or VITEST does not skip the install count - (ae24433) - Mike, Claude Opus 5.5
- say an empty CI or VITEST does not skip the install count - (dbbcfbf) - Mike, Claude Opus 5.5
- name the collector Bitfloo runs as an install count example - (9ab80ec) - Mike, Claude Opus 5.5
♻️ Refactoring
- drop the unreachable catch around noteInstall - (8948d10) - Mike, Claude Opus 5.5
Install: npx -y @bitfloo/mailoo@latest · docker pull ghcr.io/bitfloo/mailoo:0.3.4 (or 0.3.4-alpine)
Full history: CHANGELOG.md
v0.3.3
📦 Dependencies
- The Docker images install
@modelcontextprotocol/sdk1.32.2 from the
lockfile (#95). npm installs
already resolved it through the^1.32.1range.
📚 Documentation
- note that 0.3.2 published only the mailoo-mcp npm alias - (dad4c1b) - Mike, Claude Opus 5.5
Install: npx -y @bitfloo/mailoo@latest · docker pull ghcr.io/bitfloo/mailoo:0.3.3 (or 0.3.3-alpine)
Full history: CHANGELOG.md
v0.3.2
✨ Features
- add npm aliases mailoo and mailoo-mcp, republished at each release (#91) - (3699686) - Mike, Claude Sonnet 5.5
- 0.3.2 published only
mailoo-mcp: npm refused the namemailooas too
similar to an existing package.npx -y mailoo-mcp@lateststarts the same
server asnpx -y @bitfloo/mailoo@latest.
- 0.3.2 published only
🐛 Bug Fixes
- (cli) print the npx @latest entry after account add - (5384e9e) - Mike, Claude Opus 5.5
- (cli) register npx at @latest so clients pick up new releases - (9d931a2) - Mike, Claude Opus 5.5
- (release) show npx at @latest in the release notes install line - (e78a205) - Mike, Claude Opus 5.5
- launch @latest from smithery.yaml and every documented npx command - (92cc131) - Mike, Claude Opus 5.5
📚 Documentation
- say npx reuses a stale copy from the project, not only the directory - (fcd8fa8) - Mike, Claude Opus 5.5
Install: npx -y @bitfloo/mailoo@latest · docker pull ghcr.io/bitfloo/mailoo:0.3.2 (or 0.3.2-alpine)
Full history: CHANGELOG.md
v0.3.1
⚠️ Behaviour changes
list_emailsandsearch_emailspreviews now decode the part's transfer
encoding (quoted-printable or base64) and charset, and no longer go missing
behind long header blocks. Text that starts more than 4096 octets into its
part still gets no preview (#86).get_emaillists a base64 attachment at its estimated decoded size, marked
~:~195.3KBfor a 200000-byte file, previously267.3KB(#86).download_attachmentlimits still compare the encoded size in the message.
A refusal gives that size to one decimal and, for a base64 attachment, leads
with the~estimate:
Attachment "scan.pdf" is ~3.9MB (5.4MB encoded), exceeds 5MB limit.
If you match on this message, update the expected text (#86).- A refused IMAP login now reads
Login refused by the server, followed by the
server's response code in parentheses when RFC 5530 defines it, such as
(AUTHENTICATIONFAILED), instead ofCommand failed. If you match on this
message, update the expected text (#86).
🐛 Bug Fixes
- readable previews, decoded attachment sizes, clear login refusal (#86) - (74c70d1) - Mike, Claude Opus 5.5
📚 Documentation
Install: npx -y @bitfloo/mailoo@0.3.1 · docker pull ghcr.io/bitfloo/mailoo:0.3.1 (or 0.3.1-alpine)
Full history: CHANGELOG.md
v0.3.0
⚠️ Behaviour changes
- OAuth2 token requests no longer follow redirects: a token endpoint that
answers with a 3xx fails with that status, so point a customtoken_urlat
the final address. When the endpoint cannot be reached, the error says only
that, without the URL or the network error behind it. A refusal whose detail
holds part of a secret Mailoo sent is reported by its status alone. A URL in
tool params is written to the audit log as scheme, host and path, followed by
?[REDACTED]when it held credentials, a query or a fragment. (#66, #67) - An account whose IMAP or SMTP block sets
tls = falseandstarttls = false
now fails to load unless its host islocalhost, an IPv4 address in
127.0.0.0/8written in full (such as127.0.0.1), or::1. Other
spellings, such as127.1orlocalhost., are refused too. The error points
ataccounts.N.imap.tlsoraccounts.N.smtp.tlsand reads
Account "<name>": SMTP to "<host>" would be unencrypted (tls = false and starttls = false),
followed by the fix. Accounts fromMCP_EMAIL_*are checked the same way, and
mailoo account addandaccount editrefuse such a choice before they test
the connection. (#70) - To upgrade, set
tls = trueorstarttls = true, or use a loopback host such
as a local bridge on127.0.0.1; edit the config file directly, because
mailoo account editcannot open a file that fails this check. - Plain
httpfor a custom OAuth2token_urlorauth_urlis now accepted for
every address in127.0.0.0/8, not only127.0.0.1. (#70) - A token endpoint can no longer make Mailoo buffer an unbounded response body. The read stops
just past the 4096-character error cap and cancels the rest. Audit redaction ignores key case
and_/-, keeps a__proto__key as data, does not run getters, and writesmailto:,data:
andjavascript:URLs as the scheme plus[REDACTED]
(#68). mailoo account editchanges only the group it asked about.oauth2,sent_mailbox,
sieve_host,sieve_port,verify_sslanddisable_imap4rev2stay as they were, and an
identity or credential edit no longer rewrites IMAP or SMTP security
(#63).mailoo test,mailoo account addandmailoo account editno longer print the
password or OAuth2 access token when the server's error reply quotes what was sent,
raw or SASL-encoded, and they cut a long error to 300 characters
(#64).- A failed send (
send_email,reply_email,forward_email,send_draftand
scheduled sends) no longer returns, audits or queues an SMTP error that quotes the
password or OAuth2 access token. check_health, and any other tool whose IMAP or SMTP login fails, no longer returns
a connection error that quotes the password or OAuth2 access token, nor repeats it
while the next connect attempt waits.- In all of the above, when the password or access token is shorter than eight
characters, an error reply that contains it anywhere, even by chance, is withheld
whole and shows as[redacted].
🐛 Bug Fixes
- (audit) record the account that ran, not the argument as given - (30f3f89) - Mike, Claude Opus 5.5
- (audit) log alert changes, savePath writes and calendar writes - (7fc7efe) - Mike, Claude Opus 5.5
- (audit) never fail a finished tool call and keep the log owner-only - (359769a) - Mike, Claude Opus 5.5
- (body) stop the truncation notice from suggesting format="full" - (b76f38a) - Mike, Claude Opus 5.5
- (calendar) read an invitation without DTSTART instead of failing - (d674124) - Mike, Claude Opus 5.5
- (calendar) write a carriage return in Linux event text as a line break - (a689c37) - Mike, Claude Opus 5.5
- (calendar) read an invitation's METHOD when it carries a parameter - (45c3709) - Mike, Claude Opus 5.5
- (calendar) read the fields of Exchange invitations that carry a parameter as text - (a6056b5) - Mike, Claude Opus 5.5
- (calendar) set event and reminder dates without month rollover - (e4cc21e) - Mike, Claude Opus 5.5
- (calendar) show quotes and event times correctly in the confirm dialog - (63b1c79) - Mike, Claude Opus 5.5
- (calendar) write calendar state atomically and stop taking a live lock - (c0bc87c) - Mike, Claude Opus 5.5
- (calendar) match duplicates by UID or title and start time - (5efb7bb) - Mike, Claude Opus 5.5
- (calendar) build osascript JSON safely and surface its failures - (430f8bb) - Mike, Claude Opus 5.5
- (cli) keep unprompted account settings on edit (#77) - (1b08155) - Mike, Cursor
- (cli) keep default_account pointing at an account on delete and rename - (3858fe7) - Mike, Claude Opus 5.5
- (cli) keep the SMTP pool when account edit accepts detected settings - (82a12e2) - Mike, Claude Opus 5.5
- (cli) fail the launchd install when launchctl does not list the agent after loading it - (6d86b79) - Mike, Claude Opus 5.5
- (cli) mark an email overdue when a check run now would send it - (e386bbf) - Mike, Claude Opus 5.5
- (cli) unload the launchd agent before loading it so a reinstall runs the new plist - (eb2efab) - Mike, Claude Opus 5.5
- (cli) leave a crontab without the scheduler line untouched on uninstall - (1bb4751) - Mike, Claude Opus 5.5
- (cli) show emails that are still being sent in scheduler list - (3991cca) - Mike, Claude Opus 5.5
- (cli) stop account add and setup on a config file that does not load - (eca0575) - Mike, Claude Opus 5.5
- (cli) send scheduled email from cron with OAuth and save_to_sent, then close connections - (a152740) - Mike, Claude Opus 5.5
- (cli) log in with OAuth2 in the connection probe - (b8b4a32) - Mike, Claude Opus 5.5
- (config) accept an OAuth2 account with an empty password (#57) - (0165b57) - Mike
- (config) use a reserved example domain in the config template - (4b04d4f) - Mike, Claude Opus 5.5
- (config) require https for custom OAuth2 endpoints - (e820d59) - Mike, Claude Opus 5.5
- (config) report a TOML syntax error instead of "No configuration found" - (dce358a) - Mike, Claude Opus 5.5
- (connections) redact sent credentials from probe and SMTP send errors (#65) - (b2ce44d) - Mike
- (connections) refuse an account key that matches more than one account - (8835697) - Mike, Claude Opus 5.5
- (connections) keep one SMTP transport when two health checks find a stale one at once - (6e730b4) - Mike, Claude Opus 5.5
- (connections) refresh the OAuth2 token of the cached SMTP transport - (d2b67a5) - Mike, Claude Opus 5.5
- (connections) back off after a failed connect and close the failed client - (8dc7471) - Mike, Claude Opus 5.5
- (connections) share one connect per account across concurrent callers - (5ba6588) - Mike, Claude Opus 5.5
- (drafts) preview send_draft with dryRun instead of sending - (8ae714c) - Mike, Claude...
v0.2.2
✨ Features
- add toolset profiles, default account resolution, dry-run previews, and structured tool output - (61eb252) - Mike, Cursor
🐛 Bug Fixes
- (cli) point users to account add instead of the deprecated setup alias - (0ec7663) - Mike, Claude Opus 5.5
- (release) refuse a server.json version that is not X.Y.Z - (631f1fc) - Mike, Claude Opus 5.5
- (security) reuse stripHtml in preview extraction and keep env reading in config loader - (3e8ae3d) - Mike, Cursor
📚 Documentation
- (readme) list the notify commands in the CLI reference - (2638c68) - Mike, Claude Opus 5.5
- (readme) lead with account add instead of the deprecated setup alias - (e15577d) - Mike, Claude Opus 5.5
- (readme) mark MCP_EMAIL_PASSWORD optional for OAuth2 accounts - (a7b0a91) - Mike, Claude Opus 5.5
- (readme) say a clone builds with pnpm 10 - (ca2ab05) - Mike, Claude Opus 5.5
- align toolset profile counts, remove hype phrasing, and update performance roadmap - (2dc0f5a) - Mike, Cursor
- say CodeQL runs on develop pushes and ask for pnpm test in the PR template - (e4d087d) - Mike, Claude Opus 5.5
- keep the pull request CI job list in CONTRIBUTING only - (6612726) - Mike, Claude Opus 5.5
- describe what GitHub CI runs on pull requests and dispatch - (08f3a2a) - Mike, Claude Opus 5.5
♻️ Refactoring
- (release) share the X.Y.Z version check between the stamp scripts - (a4c2806) - Mike, Claude Opus 5.5
Install: npx -y @bitfloo/mailoo@0.2.2 · docker pull ghcr.io/bitfloo/mailoo:0.2.2 (or 0.2.2-alpine)
Full history: CHANGELOG.md
v0.2.1
🐛 Bug Fixes
- (ci) fail the public git checker on a commit git cannot read - (e9fb785) - Mike, Claude Opus 5.5
- (ci) fail the public git checker on an unreadable denylist - (f8f04c7) - Mike, Claude Opus 5.5
- (ci) fail the public git checker on an unreadable message file - (ade9332) - Mike
- (ci) skip the default denylist outside a git repository - (15f9c0b) - Mike
- (ci) fail the public git checker on a bad extra pattern - (b07518d) - Mike
- (docker) describe the images the way npm and the registry do - (bd676bb) - Mike, Claude Opus 5.5
- (release) stop the release when CHANGELOG.md has no section for the version - (5575a8f) - Mike, Claude Opus 5.5
- (release) keep pre-release versions off the README image tag - (bc8fee3) - Mike, Claude Opus 5.5
- (release) refuse version labels that are not full semver in the README stamp - (db275d2) - Mike, Claude Opus 5.5
- (release) write new changelog entries the way the published ones read - (dfe0edb) - Mike, Claude Opus 5.5
📚 Documentation
- (agents) drop the stale brand notes branch from oss-public-face - (23135a6) - Mike, Claude Opus 5.5
- (agents) name the unit runner in the test-auditor wrong-lane abort - (a8883f7) - Mike, Claude Opus 5.5
- (agents) write agent triggers and examples in English - (cdcf119) - Mike
- (agents) drop private tool names from contributor agents - (e5a3ce2) - Mike
- (changelog) say that features ship in patch releases - (74a354e) - Mike, Claude Opus 5.5
- (changelog) keep one entry per release, newest first - (3b5733a) - Mike, Claude Opus 5.5
- (ci) name every cause of exit 2 in the checker header - (23ede72) - Mike, Claude Opus 5.5
- (cog) describe patch-only bumps without the 0.1.x qualifier - (26284de) - Mike, Claude Opus 5.5
- (rules) leave the denylist and secret names to the checker header - (1f5b657) - Mike, Claude Opus 5.5
- (rules) point at the checker for the denylist line format - (4c01c8a) - Mike, Claude Opus 5.5
- (security) point at body_max_chars instead of repeating its limits - (2e69cc4) - Mike, Claude Opus 5.5
- stop pointing at cog.toml for the major-bump rule - (902117e) - Mike, Claude Opus 5.5
- keep the major-bump rule in CLAUDE.md alone - (515eae0) - Mike, Claude Opus 5.5
- point at cog.toml for the bump rules - (8ed9b4c) - Mike, Claude Opus 5.5
- run one test file with pnpm test - (917f918) - Mike, Claude Opus 5.5
- describe patch-only bumps without the 0.1.x qualifier - (ad0e0af) - Mike, Claude Opus 5.5
- pull the 0.2 image in the Docker examples - (d2a7994) - Mike, Claude Opus 5.5
- drop the deleted main branch from docs, cog and CI - (0ebfe83) - Mike, Claude Opus 5.5
- name develop as the release line - (60bb39c) - Mike
- list every field System One sends to the classifier - (b782938) - Mike
Install: npx -y @bitfloo/mailoo@0.2.1 · docker pull ghcr.io/bitfloo/mailoo:0.2.1 (or 0.2.1-alpine)
Full history: CHANGELOG.md
v0.2.0
✨ Features
🐛 Bug Fixes
- bind the export size limit to one constant - (e7d12dc) - Mike
Install: npx -y @bitfloo/mailoo@0.2.0 · docker pull ghcr.io/bitfloo/mailoo:0.2.0 (or 0.2.0-alpine)
Full history: CHANGELOG.md
v0.1.8
🐛 Bug Fixes
- close CodeQL host and HTML-sanitizer bypasses - (5a82098) - Mike, Cursor
- treat only real Gmail hosts as already filing Sent mail - (d59a14c) - Mike, Cursor
- strip event handlers glued to the previous attribute - (e97a7cd) - Mike, Cursor
- reject private session links in commit messages - (6463342) - Mike, Cursor
📚 Documentation
- (readme) label the M8ven badge neutrally - (2d67d44) - Mike, Cursor
- (readme) make the CI badge follow pull request runs - (1d111b2) - Mike, Cursor
- (readme) pull the 0.1 image tag in the examples - (be840ec) - Mike, Cursor
- explain the commit message check in plain words - (b40c68f) - Mike, Cursor
♻️ Refactoring
- (email-body) move HTML sanitizing into its own module - (520169a) - Mike, Cursor
Install: npx -y @bitfloo/mailoo@0.1.8 · docker pull ghcr.io/bitfloo/mailoo:0.1.8 (or 0.1.8-alpine)
Full history: CHANGELOG.md