Skip to content

v0.1.0 — hardened fork, first release

Choose a tag to compare

@Fe2-O3 Fe2-O3 released this 28 Sep 18:41
· 123 commits to main since this release

Email MCP Server — v0.1.0

The hardened fork of codefuturist/email-mcp ships its first release.

tests
tools
issues closed
upstream

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, 0 disables).
  • 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 add

Client 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.0 tag starts the fork's own version line (the package was frozen at upstream's dev version 0.3.0 before this release); an inherited copy of upstream's ancient v0.1.0 tag was replaced to make room.