dead-letter — Claude Code MCP server: what it does, how to install
dead-letter converts .eml and .mbox files into clean Markdown with YAML front matter for RAG and LLM agents. Ideal for turning messy email dumps into readable archives.
no license ★ 8 updated 2026-10-23
claude mcp add dead-letter -- uvx dead-letterWhat dead-letter does
Raw .eml files clutter context windows with MIME boundaries, multipart blocks, and base64 payloads. The dead-letter MCP server extracts clean message bodies and metadata into Markdown. It separates Gmail and Outlook thread replies, removes signature blocks, and summarizes calendar invites.
Processing stays on your machine. You do not need an account or an API key. Binary attachments like PDFs can be routed to an attachments/ folder, keeping Markdown files focused on text. Without uv installed on your system, the server will not launch.
What it helps with
- strip MIME boundaries and base64 strings from exported emails
- segment message replies from Outlook and Gmail threads
- generate Markdown notes with YAML metadata from .eml files
- extract attachments and calendar events into local folders
Example prompts for the agent
- Convert all .eml files in the
./mail-dumpfolder into Markdown - Parse
customer_thread.emland summarize the message exchange - Extract attachments and front matter metadata from
contract.eml
How to install dead-letter
Platform CLI
claude mcp add dead-letter -- uvx dead-letteruvx runs the command named after the package; if the README names another one, use uvx --from dead-letter <command>
Platform CLI
codex mcp add dead-letter -- uvx dead-letteruvx runs the command named after the package; if the README names another one, use uvx --from dead-letter <command>
Config file
{
"mcpServers": {
"dead-letter": {
"command": "uvx",
"args": [
"dead-letter"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from dead-letter <command>
Config file
{
"servers": {
"dead-letter": {
"type": "stdio",
"command": "uvx",
"args": [
"dead-letter"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from dead-letter <command>
Platform CLI
gemini mcp add dead-letter uvx dead-letteruvx runs the command named after the package; if the README names another one, use uvx --from dead-letter <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about dead-letter
How do I install dead-letter in Claude Code?
Run claude mcp add dead-letter -- uvx dead-letter in your terminal. This requires uv to be installed on your machine.
What does dead-letter do?
It converts .eml and .mbox email archives into structured Markdown documents with YAML front matter. It also parses message threads, cleans HTML markup, and tracks attachments.
Does dead-letter require an external API key?
No, the conversion engine runs completely offline on your local computer. An external service or account is not needed to process emails.