What it does
dead-letter converts .eml email exports into Markdown with YAML front matter. It splits threads, strips signatures, extracts attachments and parses calendar events, handling one file or a whole directory. Its interfaces include a CLI, a Python API, a local web UI with drag-and-drop import and processing history, an MCP server, a Claude plugin with five slash commands, and a portable Agent Skill.
It suits building a readable email archive, moving messages into Markdown-based knowledge systems such as Obsidian, or preparing email for RAG and LLM pipelines without passing raw MIME and base64 into the context window. It can also retain human-readable message content independent of any one mail client. In a publisher benchmark on an 11-message synthetic corpus, the reported aggregate used about 88% fewer tokens than the raw .eml, and attachment names were retained in 2 of 2 cases against 0 of 2 for a naive baseline.
No account, upload or API key is required, and conversion runs locally. Installation is possible via Homebrew (CLI and, from version 0.4.7, the MCP server; Apple silicon macOS), pip, pipx, uvx or from source. The web UI needs the dead-letter[ui] extra, and the dead-letter doctor command checks the runtime environment.
Limitations and requirements
The uvx trial commands are not version-pinned, so pin a version for a reviewed deployment. The Homebrew formula does not include the web UI. The MCP host may send returned email text to a remote model, even though conversion itself is local. Benchmark counts measure the Markdown representation only, not the contents of retained binary attachments or downstream answer quality, and naive extraction uses fewer tokens when metadata, links and thread structure are discarded. The benchmark uses structured thread mode, while the shipping default is latest-message mode.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
dead-letter
Convert .eml and .mbox email to clean Markdown for RAG, LLM pipelines, and local knowledge bases
v0.4.10As shown on registry.modelcontextprotocol.io when we last read it