BigCactusLabs/dead-letter

Overview

Dead Letter is a Python tool that converts .eml email files into Markdown documents with YAML front matter. It extracts metadata like subject, sender, and date and formats the email body as Markdown. The output is a clean plain-text representation suitable for further processing or archival.

Best for

Best for
Developers who need to batch convert .eml files to plain-text Markdown for archival or indexing

Use cases

• Archive email exports as readable Markdown files
• Migrate email content into static site generators or knowledge bases
• Extract and transform email data for documentation or search indexing

How to use

Install

pip install dead-letter[mcp]

Tools exposed

• dead-letter-mcp

Tested with

Claude Desktop, Claude Code, Codex

Example client config

{\n  "mcpServers": {\n    "dead-letter": {\n      "command": "uv",\n      "args": ["--directory", "/path/to/dead-letter", "run", "--extra", "mcp", "dead-letter-mcp"]\n    }\n  }\n}

Notes

Dead Letter is a Python tool that converts .eml email files into Markdown documents with YAML front matter. It extracts metadata like subject, sender, and date and formats the email body as Markdown. The output is a clean plain-text representation suitable for further processing or archival.

4 stars on GitHub. Last updated 2026-07-13.

Use cases

• Archive email exports as readable Markdown files
• Migrate email content into static site generators or knowledge bases
• Extract and transform email data for documentation or search indexing

Pros

• Simple focused tool with a single clear purpose
• Lightweight open source implementation in Python
• Produces structured output with YAML metadata

Cons

• Only supports the .eml format, not other email exports
• Does not handle attachments or render HTML email bodies
• Limited adoption with only 4 stars on GitHub

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.