Repository navigation
v0.1.0 — hardened fork, first release
84 commits past the fork point. Every fix links the upstream issue it closes — all 17 were verified still open after upstream's v0.5.1.
Highlights
- All 17 open critical bugs fixed — sent-mail filing, attachments on send, disk saves, llama.cpp-safe schemas, date ordering, multipart bodies, duplicate-send guard, orphan-process leak, the 6-day OOM, and more. Full table in What's Fixed.
- 13 security hardening controls — header injection, timing attacks, private-IP SSRF, HTTPS-only OAuth, loopback token requirement, owner-only credential files, bounded request bodies, and a disclosure policy in SECURITY.md.
- Large mailboxes work — UID fetches chunked at 400 per command; list/search/stats verified on a 64,779-message Hostinger mailbox.
- No orphan processes — exits when the client closes stdin, plus
settings.idle_exit(default 30 min,0disables). - macOS Keychain +
password_command— no plaintext passwords at rest (1Password, Bitwarden, pass, any shell command).
Ported from upstream v0.5.1
Credit where due — three wins from the upstream release train of 2026-09-26 were adopted instead of left as gaps:
| Ported | Upstream commit | Why |
|---|---|---|
TLS servername repair for IP-literal hosts |
70d4215 |
Every IMAP login to an IP address died before auth — shared bug, fixed in all three construction sites via createImapClient() |
config validate |
bf09dcc |
Syntax, schema, did-you-mean typo detection, consistency checks; exit 1 on errors |
| Dependency set (v0.4.1 line) | bae1bb7 |
imapflow 2, nodemailer 10, vitest 5, zod 4.6, @clack/prompts 1.8 — with type adaptations, full suite green |
The rest of the upstream v0.5 line (OTP catcher, HTTP daemon lifecycle, shell completion, bun binaries) is drafted — not silently skipped — in docs/upstream-v0.5-draft.md.
Verification
pnpm typecheck clean
pnpm test 428/428 passed (55 files)
pnpm build clean
pnpm check biome clean (161 files)
config validate real user config → exit 0; typo/exit-1 path proven on a temp config
Install
git clone https://github.com/Fe2-O3/email-mcp.git
cd email-mcp
pnpm install && pnpm build
node dist/main.js account addClient setup (Claude Desktop/Code, Cursor, VS Code, Codex, OpenCode with timeout: 180000, Streamable HTTP) is in the README.
Notes
- Full changelog: CHANGELOG.md
- Upstream's own releases (v0.1.0 → v0.5.1) remain at codefuturist/email-mcp/releases. This repository's
v0.1.0tag starts the fork's own version line (the package was frozen at upstream's dev version0.3.0before this release); an inherited copy of upstream's ancient v0.1.0 tag was replaced to make room.