Skip to content
Agentmart
Submit a tool

dead-letter

Convert.eml and.mbox email to clean Markdown for RAG, LLM pipelines, and local knowledge bases

Connector by BigCactusLabs · GitHub account verified by the MCP Registry

IndexedLicense unknownLocal (stdio)★ 8
Write a review

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/bigcactuslabs-dead-letter

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Convert .eml and .mbox email to clean Markdown for RAG, LLM pipelines, and local knowledge bases

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
5 read · 0 write · 0 deleteRead-only
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 5

Read from the source code; the running server may list different tools.

Read 5 · Look things up without changing anything.

  • convert_directory
  • convert_eml
  • convert_eml_to_bundle
  • convert_mbox
  • get_diagnostics

Network hosts it talks to 11

  • api.github.com · found in code
  • api.typesafe.ai · found in code
  • cline.github.io · found in code
  • cursor.com · found in code
  • example.test · found in code
  • ghcr.io · found in code
  • github.com · found in install command, code
  • github.com.helper · found in code
  • raw.githubusercontent.com · found in code
  • typesafe.ai · found in code
  • vscode.dev · found in code

Files it touches

  • /private/tmp
  • Your home directory (~)
  • ~/letters/Cabinet
  • ~/letters/Inbox
  • Any path the agent passes to its tools

Tools (5)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • convert_directoryConvert email folder

    Batch convert all .eml files in a directory to Markdown. Recursively finds .eml files (at most 50 per call; larger directories are rejected before any conversion). output_directory is required: Markdown is written there, mirroring subfolders, and source .eml files are left in place. Returns a JSON summary with total, successes, failures, output_paths, and errors. Each errors entry contains file and error_code (defaulting to conversion_error), never raw exception text. Use convert_eml to retrieve individual converted file content.

  • convert_emlConvert email

    Convert a .eml email file to Markdown with YAML front matter. Returns the full Markdown content (front matter + body). When output_path is provided, also writes the file to disk. Attachments are listed in the front matter but not written to disk; use convert_eml_to_bundle to save the decoded attachment files. thread_mode="structured" adds a section per earlier reply or forwarded message. Gmail HTML forwards and unquoted plain-text forwards are kept in latest mode too; a plain-text forward inside ">" quoting is not. Presets bundle common flag combinations: - default: strips signatures, trac…

  • convert_eml_to_bundleConvert email to bundle

    Convert a .eml file to a self-contained bundle with markdown and attachments. Creates a directory containing the converted markdown, extracted attachments, and optionally the original .eml source. source_handling only accepts 'copy' over MCP: the original .eml is copied into the bundle and left untouched. The 'move' and 'delete' modes are rejected here — use the CLI or the Python API for those. Returns JSON with bundle_path, markdown_path, attachment_paths, and optional diagnostics.

  • convert_mboxConvert MBOX archive

    Convert one flat .mbox archive (e.g. Gmail Takeout) to Markdown files. Bounded: the archive must be at most 256 MiB, and conversion stops after 1000 messages (the response then has truncated=true; use the dead-letter CLI for larger archives). Compressed archives and Apple Mail .mbox directories are rejected. output_directory is required; one .md per message (or one bundle directory when bundles=true) is written there with a collision-safe JSON report. The source archive is never modified. Returns a JSON summary (processed, converted, skipped, failed, truncated, report_path, and at most 20 fa…

  • get_diagnosticsGet conversion diagnostics

    Inspect email quality and structure without writing permanent files. Use this to assess conversion quality before committing, or to troubleshoot problematic .eml files. Always returns JSON with: state (normal/degraded/review_recommended), selected_body, segmentation_path, client_hint, confidence, fallback_used, and warnings. Two keys are conditional: stripped_images appears only when images were removed, and attachments only when the message had attachments eligible for retention.

Signals

Stars
8
Forks
0
Open issues
25
Weekly downloads
377
Last commit
Oct 22, 2026 (6 days ago)
Last release
Oct 22, 2026 (6 days ago)
Last package publish
Oct 22, 2026 (6 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.BigCactusLabs/dead-letter
Version
0.4.9
Auth
No auth
Packages
pypi dead-lettermcpb https://github.com/BigCactusLabs/dead-letter/releases/download/v0.4.9/dead-letter-mcp-0.4.9.mcpboci ghcr.io/bigcactuslabs/dead-letter@sha256:0023516c85b2e5464d7a73cf037289f43d4aa8f44f13dbb6f4e09f5b9f9fa8c7
License
License unknown
Repository
github.com/BigCactusLabs/dead-letter
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

dead-letter MCP server. Agent Mart. https://agentmart.dev/connectors/bigcactuslabs-dead-letter (last updated 2026-10-25)