dead-letter
dead-letter
你的 .eml 文件值得拥有第二次生命。
dead-letter 将电子邮件导出转换为带有 YAML front matter 的干净 Markdown——线程拆分、签名剥离、附件提取、日历解析。一个文件或一万个文件都可以。
✨ 功能特性
全保真转换 — HTML 清理、Gmail/Outlook 线程分段、内联图片处理以及日历事件摘要
CLI — 指向文件或目录即可运行
本地 Web UI — 深色指挥中心界面,支持拖放导入、监视模式、转换等级徽章、处理历史记录和每项任务的诊断信息
Inbox/Cabinet 工作流 — 将
.eml文件放入 Inbox,让 dead-letter 将 Markdown bundle 整理到 Cabinet 中安装验证 —
dead-letter doctor检查你的运行时环境转换报告 — 可选的 JSON 报告,包含每个文件的诊断信息,包括附件引用/保留计数,用于自动化和审计
MCP 服务器 — 与 Claude Desktop、Claude Code、Codex 及其他 MCP 客户端集成
Claude 插件 — 在 Claude Code 或 Cowork 中一键安装,提供四个斜杠命令(
/dead-letter:convert、/dead-letter:summarize、/dead-letter:triage、/dead-letter:cabinet)Python API —
from dead_letter import convert即可开始使用
Related MCP server: DingusMail
🧠 为 LLM 管道而生
原始 .eml 文件对于下游 LLM 和检索管道来说是噪声较大的输入——MIME 头、多部分边界、重复的 HTML/纯文本正文以及编码附件都会混入文本路径中。
dead-letter 将其规范化为带有 YAML front matter 的 Markdown,因此消息文本和元数据无需 MIME 解析或 base64 清理即可用于分块或索引。默认情况下,convert() 和 convert_dir() 运行时会为每条消息写入一个 .md 文件,并将附件名称保留在 front matter 中。
如果你还希望文件系统产物也分离出来,bundle 和 Cabinet 工作流会写入 message.md,并将保留的解码文件放在 attachments/ 下。Markdown 可直接用于文本摄取,而 PDF、电子表格、日历文件和其他保留的二进制附件则被干净地分离出来,供你已有的任何下游解析器使用。
对于直接 LLM 集成,MCP 服务器让 Claude Desktop、Claude Code、Codex 及其他 MCP 客户端无需通过 shell 即可调用 dead-letter 的转换工具。
📊 Token 成本基准
dead-letter 的价值不在于比所有替代方案使用更少的 token——而在于每个 token 的保真度:保持电子邮件完整的最廉价表示。在包含 HTML 线程、附件和新闻通讯的合成语料库上测量(分词器 o200k_base,中位数):
比原始
.eml减少约 88% 的 token — 一封带 PDF 附件的电子邮件原始约 126k token,转换后约 180。唯一能保持电子邮件完整的表示 — 线程结构、每条消息的发件人归属、链接和附件元数据都得以保留。朴素文本提取之所以更便宜,恰恰是因为它丢弃了这些内容(保留 0/2 个附件,而 dead-letter 保留 2/2 个)。
基准测试诚实地说明了它在哪些方面会逊色:如果你不介意丢弃附件、链接和线程结构,朴素提取的 token 更少。完整方法、完整表格(包括这些行)、分词器说明以及一条命令即可复现,均见 benchmarks/。
📦 安装
在 Apple 芯片 macOS 上使用 Homebrew:
brew tap BigCactusLabs/tap
brew install dead-letterHomebrew formula 仅安装核心 CLI:dead-letter convert 和 dead-letter doctor。它有意不捆绑可选的 Web UI 或 MCP 服务器依赖栈。
使用 pip:
pip install dead-letter # core + CLI
pip install dead-letter[cli] # + watchfiles (used by backend/UI watch mode)
pip install dead-letter[ui] # + web UI, API server, and watch mode
pip install dead-letter[mcp] # + MCP server使用 pipx 进行隔离的 UI 或 MCP 安装:
pipx install 'dead-letter[ui]' # installs dead-letter and dead-letter-ui
pipx install 'dead-letter[mcp]' # installs dead-letter and dead-letter-mcp从源码安装:
git clone https://github.com/BigCactusLabs/dead-letter.git
cd dead-letter
uv sync --extra dev # all extras
uv sync --extra ui # UI only
uv sync --extra mcp # MCP only🚀 快速开始
CLI — 转换单个文件:
dead-letter convert message.eml转换整个目录:
dead-letter convert inbox/ --output out/在输出旁边生成 JSON 转换报告:
dead-letter convert inbox/ --output out/ --report使用 --output 时,报告会以 .dead-letter-report.json 的形式写入该输出目录。不使用 --output 时,文件转换会将报告写在源消息旁边,目录转换则将其写入输入目录根目录。
检查你的运行时环境:
dead-letter doctor目录转换会递归扫描 .eml 文件,不区分大小写地匹配后缀,跳过解析目标超出所请求输入树的符号链接文件,并去重解析到同一消息文件的树内符号链接别名。
Web UI — 启动本地服务器:
dead-letter-ui --host 127.0.0.1 --port 8765打开 http://127.0.0.1:8765 — 首次启动时,设置提示会建议默认的 Inbox 和 Cabinet 文件夹。配置或跳过即可开始转换。通过拖放或文件选择器导入 .eml 文件。单文件导入使用文件模式,而多文件拖放会创建一个目录模式的批处理任务。混合拖放会在跳过非 .eml 文件前要求确认。后端对单个和批量上传均强制执行每个文件 100 MB 的导入限制。
从源码检出目录运行时,加上 uv run 前缀:
uv run dead-letter convert message.eml
uv run --extra ui dead-letter-ui --host 127.0.0.1 --port 8765🐍 Python API
from dead_letter import convert
result = convert("message.eml")
print(result.subject, result.sender)
print(result.output) # path to the generated .md使用选项:
from dead_letter import convert, ConvertOptions
result = convert("message.eml", options=ConvertOptions(
strip_signatures=True,
strip_quoted_headers=True,
))去除签名图片(徽标、社交图标)和跟踪像素:
result = convert("message.eml", options=ConvertOptions(
strip_signature_images=True,
strip_tracking_pixels=True,
))启用后,这些过滤器会从渲染的 Markdown 中移除匹配的图片,并从 bundle 附件输出中省略被剥离的内联签名/跟踪资源。
Bundle 转换(Markdown + 附件 + 源文件位于同一目录):
from dead_letter import convert_to_bundle
bundle = convert_to_bundle("message.eml", bundle_root="cabinet/", source_handling="copy")
print(bundle.markdown) # cabinet/message/message.md
print(bundle.attachments) # retained extracted files under cabinet/message/attachments/source_handling="copy" 会将原始 .eml 保留在原处。如果省略,convert_to_bundle() 默认使用 source_handling="move",并将源消息移入 bundle。
保留的提取附件文件名在写入 attachments/ 之前会被规范化为安全的基名。
当消息包含符合保留条件的附件时,质量诊断会包含引用/保留附件计数,因此被丢弃的产物可以被机器检测到。参见 Quality Diagnostics。
批量处理:
from dead_letter import convert_dir
for r in convert_dir("inbox/", output="out/"):
print(f"{'✓' if r.success else '✗'} {r.source.name}")🔌 MCP 服务器
dead-letter 附带一个 MCP 服务器,使 LLM 客户端无需通过 shell 即可直接转换 .eml 文件。
安装并启动:
pip install dead-letter[mcp]
dead-letter-mcp从源码检出目录:
uv run --extra mcp dead-letter-mcpClaude Desktop — 添加到 claude_desktop_config.json:
{
"mcpServers": {
"dead-letter": {
"command": "uv",
"args": ["--directory", "/path/to/dead-letter", "run", "--extra", "mcp", "dead-letter-mcp"]
}
}
}Claude Code 或 Cowork(推荐 — Claude 插件):
/plugin marketplace add BigCactusLabs/bigcactuslabs-plugins
/plugin install dead-letter该插件捆绑了 MCP 服务器(通过 uvx,无需 pip install — 只需 PATH 上有 uv),并添加了四个斜杠命令:/dead-letter:convert、/dead-letter:summarize、/dead-letter:triage、/dead-letter:cabinet。通过插件处理的电子邮件内容被视为不可信数据而非指令,因此消息中嵌入的工具使用、凭据和泄露请求不会被遵循。源码位于 plugin/。
插件市场会固定每个已发布插件标签和提交。发布自动化仅在捆绑的 MCP 服务器的确切 PyPI 版本上线后才更新该指针,因此 Claude Code 和 Cowork 解析到的是相同的可重现版本。
Claude Code(手动添加 MCP — 替代方案):
claude mcp add dead-letter -- uv run --extra mcp dead-letter-mcpCodex:
codex mcp add dead-letter -- uv run --extra mcp dead-letter-mcp
codex mcp listcodex mcp add 命令会注册本地的 dead-letter MCP 服务器,codex mcp list 可验证它是否可用。
工具
工具 | 必需参数 | 返回值 |
|
| Markdown 文本。当指定 |
|
| 包含 |
|
| JSON 摘要。每次调用最多处理 50 个 |
|
| 质量和结构 JSON。不写入任何永久内容。 |
这四个工具都接受 preset(default、clean、verbose、raw)和逐标志覆盖。完整契约(包括仅限 MCP 的约束和错误文本表):docs/reference/v4-runtime-contracts.md。
🗂 项目结构
src/dead_letter/
├── core/ # conversion pipeline (MIME, HTML, threads, rendering)
├── backend/ # CLI, API server, job runner, watch mode, MCP server
└── frontend/ # static web UI (Alpine.js ES modules + vanilla fetch)
tests/
├── core/ # conversion pipeline tests with .eml fixtures
├── backend/ # API, job, and watch tests
├── plugin/ # Claude plugin manifest, skill, and command tests
└── frontend/ # JS unit tests🧪 测试
uv run pytest -q tests/core # conversion pipeline
uv run pytest -q tests/backend # API and job runner
uv run pytest -q tests/plugin # Claude plugin manifest, skill, and command surfaces
node --test tests/frontend/*.test.js # frontendCI 在 PR 以及推送到 main 或 feat/** 分支时使用相同命令运行全部四项测试,另外还会运行 npx --yes @anthropic-ai/claude-code@2.1.145 plugin validate plugin/ 和 node --check src/dead_letter/frontend/static/app.js。
📚 文档
Docs Index — 公共文档着陆页
Runtime Contracts — 完整 API 和核心行为规范
Agent Guide — 面向在此仓库中工作的 AI 编码代理的操作指南
🔧 我们喜爱的工具
MarkEdit — Markdown 版 TextEdit,原生 macOS,约 4 MB。打开 dead-letter 的输出,就像它天生就该放在那里一样。
mo — 本地 Markdown 查看器,在浏览器中渲染文件并支持实时重载。将其指向你的 Cabinet,像阅读信息流一样阅读转换后的邮件。
⚠️ 已知限制
仅限本地 — 无远程服务器,无身份验证
内存中的任务注册表(重启后状态重置)
单用户、单机
许可证
PolyForm Noncommercial 1.0.0 — 免费用于个人、教育和非营利用途。商业使用需要从 Big Cactus Labs 获取单独的许可证。
Available Tools
4 toolsconvert_directoryA
Batch convert all .eml files in a directory to Markdown.
Recursively finds all .eml files and converts them. Returns a JSON summary with total, successes, failures, output_paths, and errors.
Use convert_eml to retrieve individual converted file content.
| Name | Required | Description | Default |
|---|---|---|---|
| preset | No | default | |
| dry_run | No | ||
| directory | Yes | ||
| thread_mode | No | latest | |
| thread_order | No | oldest-first | |
| include_raw_html | No | ||
| output_directory | No | ||
| strip_signatures | No | ||
| strip_disclaimers | No | ||
| embed_inline_images | No | ||
| include_all_headers | No | ||
| no_calendar_summary | No | ||
| strip_quoted_headers | No | ||
| strip_tracking_pixels | No | ||
| strip_signature_images | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description adds value by stating batch conversion, recursion, and JSON summary structure, but lacks info on side effects, permissions, or limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three concise sentences, front-loaded with purpose, no fluff, and ends with a helpful alternative reference.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (15 parameters), the description covers only basic behavior and output, leaving the agent without insight into key configuration options.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage and 15 parameters, the description provides no explanation for any parameter beyond the directory. Agent has no guidance on presets, dry_run, etc.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool batch converts .eml files in a directory to Markdown, with recursive behavior, and distinguishes itself from sibling convert_eml by mentioning individual file retrieval.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides a clear alternative: use convert_eml for individual file content. However, it does not explicitly state when not to use this tool or mention the sibling convert_eml_to_bundle.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
convert_emlA
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.
Presets bundle common flag combinations:
default: strips signatures, tracking pixels, signature images
clean: default + strips disclaimers and quoted headers
verbose: includes all headers and raw HTML
raw: no stripping, preserves everything
Individual flags override the preset when provided.
| Name | Required | Description | Default |
|---|---|---|---|
| preset | No | default | |
| eml_path | Yes | ||
| output_path | No | ||
| thread_mode | No | latest | |
| thread_order | No | oldest-first | |
| include_raw_html | No | ||
| strip_signatures | No | ||
| strip_disclaimers | No | ||
| embed_inline_images | No | ||
| include_all_headers | No | ||
| no_calendar_summary | No | ||
| strip_quoted_headers | No | ||
| strip_tracking_pixels | No | ||
| strip_signature_images | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It discloses the return value (Markdown with front matter), the optional disk write, and the behavior of presets and flag overrides. However, it does not explain the thread_mode and thread_order parameters, leaving some behavioral aspects unexplained.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with six sentences, front-loaded with the core action, and uses a clear bullet-like list for presets. Every sentence adds value without repetition or fluff.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (14 parameters, presets, output schema), the description covers the main purpose, return value, presets, and override logic. It lacks explanation for thread_mode and thread_order, but overall provides sufficient context for most use cases.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must add meaning. It explains presets and mentions several flags (signatures, tracking pixels, etc.), and notes that individual flags override presets. However, it omits details for thread_mode, thread_order, and some boolean flags. The presets bundling compensates partially.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool converts .eml to Markdown with YAML front matter, specifying the output format and the optional file write. It implicitly distinguishes from siblings like convert_directory and convert_eml_to_bundle by focusing on a single file conversion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear guidance on preset usage and flag overrides, but it does not explicitly state when to use this tool versus sibling tools like convert_directory or convert_eml_to_bundle, which would help an agent choose correctly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
convert_eml_to_bundleB
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.
| Name | Required | Description | Default |
|---|---|---|---|
| preset | No | default | |
| eml_path | Yes | ||
| bundle_root | Yes | ||
| thread_mode | No | latest | |
| thread_order | No | oldest-first | |
| source_handling | No | copy | |
| include_raw_html | No | ||
| strip_signatures | No | ||
| strip_disclaimers | No | ||
| embed_inline_images | No | ||
| include_all_headers | No | ||
| no_calendar_summary | No | ||
| strip_quoted_headers | No | ||
| strip_tracking_pixels | No | ||
| strip_signature_images | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states that the tool creates a directory, copies the .eml, leaves the source untouched, and returns a JSON structure with specific fields. It also discloses that move/delete modes are rejected. However, it does not mention potential side effects like overwriting existing directories, error handling, or permissions. Still, the core mutation and side-effect profile is clear, warranting a 4.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is about 120 words, organized into a brief purpose statement, a note on source_handling, and a return-value summary. It is not excessively verbose and front-loads the core action. Some redundancy exists (e.g., stating the return format), but it remains appropriately sized for the complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite an output schema (which the description partially covers by naming returned fields), the tool has 15 parameters and 0% schema description coverage. The description only addresses source_handling, leaving the meaning of presets, thread modes, and all boolean flags unexplained. This is a significant gap for an agent to invoke the tool correctly with the full range of options.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It only explains source_handling, noting the 'copy' limitation. The other 14 parameters (preset, thread_mode, thread_order, boolean flags) are left undefined. The description adds value for one parameter but fails to clarify the vast majority, leaving agents without essential meaning for the options they may set.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: converting an .eml file into a self-contained bundle with markdown and attachments. It uses a specific verb and resource, but does not differentiate from sibling tools like convert_eml or convert_directory. The purpose is unambiguous, earning a 4 rather than a 5 because it lacks explicit sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides a constraint on source_handling (only 'copy' is accepted over MCP, with guidance to use CLI/API for other modes) but does not explain when to choose this tool over its siblings. There is no mention of convert_eml, convert_directory, or get_diagnostics as alternatives for different scenarios. The guidance is parameter-specific rather than tool-selection-focused.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_diagnosticsA
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.
| Name | Required | Description | Default |
|---|---|---|---|
| preset | No | default | |
| eml_path | Yes | ||
| thread_mode | No | latest | |
| thread_order | No | oldest-first | |
| include_raw_html | No | ||
| strip_signatures | No | ||
| strip_disclaimers | No | ||
| embed_inline_images | No | ||
| include_all_headers | No | ||
| no_calendar_summary | No | ||
| strip_quoted_headers | No | ||
| strip_tracking_pixels | No | ||
| strip_signature_images | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of disclosing behavior. It explicitly states the operation is non-destructive ('without writing permanent files'), and thoroughly describes the return structure: 'Always returns JSON with: state (normal/degraded/review_recommended), selected_body, segmentation_path, client_hint, confidence, fallback_used, and warnings.' It also details conditional keys (stripped_images only when images removed, attachments only when eligible), providing comprehensive insight into output behavior without relying on annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured and concise: it opens with the core purpose, then provides usage guidance, and ends with a precise list of return keys and conditional behaviors. Each sentence adds value, there is no fluff, and the most critical information (non-destructive, purpose, use cases) is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
While the description thoroughly explains the return format and gives usage context, it leaves the 13 parameters completely undocumented. Given the tool's complexity (multiple enums, boolean toggles) and the lack of schema descriptions, an agent would not be able to correctly configure parameters without external knowledge. The output schema exists (per context signals) and the description explains return values, but the absence of parameter semantics makes the definition incomplete for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 0% description coverage, and the description provides no explanation of any of the 13 parameters. While the description mentions some related behaviors (e.g., conditional keys for stripped images and attachments), it does not explain what parameters like 'preset', 'thread_mode', 'strip_signatures', or 'include_raw_html' actually control. The agent is left to infer from parameter names alone, which is insufficient for a tool with this many options. The description fails to compensate for the schema's lack of parameter descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Inspect email quality and structure without writing permanent files.' It specifies the verb ('inspect'), the resource ('email quality and structure'), and the non-destructive nature. It also names use cases ('assess conversion quality before committing, or to troubleshoot problematic .eml files'), which effectively distinguishes it from the sibling conversion tools (convert_eml, convert_eml_to_bundle, convert_directory) that perform transformations rather than inspection.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit usage scenarios: 'Use this to assess conversion quality before committing, or to troubleshoot problematic .eml files.' This gives clear context for when to use the tool. However, it does not explicitly state when not to use it or mention the sibling conversion tools as alternatives, relying on the implicit inference that conversion tools are for transforming files while this inspects them. A slight improvement would be naming the alternatives directly, so 4.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
4 tool updates
v0.2.4- First observed
convert_directory - First observed
convert_eml - First observed
convert_eml_to_bundle - First observed
get_diagnostics
TDQS
The tools have distinct purposes: batch conversion, single conversion, bundle conversion, and diagnostics. However, convert_eml and convert_eml_to_both overlap as single-file converters, though descriptions clarify the difference in output. No tools are truly ambiguous.
All conversion tools follow a consistent 'convert_' prefix, while get_diagnostics uses 'get_'. The pattern is clear and logical for each tool's function, with only one deviation that is still fitting.
With 4 tools, the server is well-scoped for an email conversion utility. Each tool serves a distinct and necessary function without redundancy or bloat.
The set covers batch conversion, single conversion, bundle creation, and diagnostics. A possible gap is the lack of a tool to manage or list existing bundles, but the core conversion workflow is complete.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
Email safety MCP server. Detects phishing, prompt injection, CEO fraud for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceA local MCP server that provides LLM clients with read/write access to email and calendar data from Gmail, iCloud, and generic IMAP providers. It runs entirely on your machine, keeping data private while enabling email management, calendar operations, and task handling through natural language.39MIT
- AlicenseAqualityDmaintenanceMCP server for parsing .eml email files, extracting metadata, content, and attachments with smart organization into folders. Enables AI to read and handle email files offline without triggering trackers.22AGPL 3.0
- FlicenseNot gradedqualityBmaintenanceA private, single-user MCP server that unifies Gmail, Microsoft 365/Outlook, and IMAP mailboxes for LLMs to search and read emails live, without storing or caching mailbox contents.-
- AlicenseCqualityBmaintenanceA local-first Python MCP server that turns Gmail, Outlook/Microsoft 365, iCloud Mail, and generic IMAP/SMTP mailboxes into a synchronized, searchable OKF knowledge layer, exposing 38 tools and four resources for mailbox actions, synchronization, retrieval, attachments, and optional semantic search while keeping the provider mailbox authoritative.38MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/BigCactusLabs/dead-letter'
If you have feedback or need assistance with the MCP directory API, please join our Discord server