Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add dead-letter -- uvx dead-letter
Open on GitHub

What 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-dump folder into Markdown
  • Parse customer_thread.eml and 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-letter

uvx 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open