dead-letter
This MCP server converts .eml email files to clean Markdown, bundles attachments, and analyzes conversion quality.
convert_eml: Convert a single .eml to Markdown (with YAML front matter), optionally writing to an output path; returns full Markdown content.
convert_eml_to_bundle: Convert a .eml into a self-contained bundle directory containing the Markdown, extracted attachments, and optionally a copy of the original source (only copy mode is supported over MCP).
convert_directory: Batch-convert all .eml files in a directory recursively, with dry-run mode, writing Markdown to an optional output directory and returning a JSON summary of successes/failures/paths/errors.
get_diagnostics: Inspect an email's quality and structure (state, segmentation, client hint, confidence, warnings, stripped images, attachments) without writing permanent files.
All tools accept conversion presets (default, clean, verbose, raw) and individual flag overrides for thread mode/order, signature/disclaimer/tracking-pixel stripping, raw HTML inclusion, inline image embedding, header inclusion, and calendar summaries.
dead-letter
Your .eml files deserve a second life.
dead-letter converts email exports into clean Markdown with YAML front matter — threads split, signatures stripped, attachments extracted, calendars parsed. One file or ten thousand.
✨ Features
Full-fidelity conversion — HTML sanitization, Gmail/Outlook thread segmentation, inline image handling, and calendar event summaries
CLI — point it at a file or a directory and go
Local web UI — dark command-center interface with drag-and-drop import, watch mode, conversion grade badges, processing history, and per-job diagnostics
Inbox/Cabinet workflow — drop
.emlfiles into an Inbox, let dead-letter organize the Markdown bundles into a CabinetInstall validation —
dead-letter doctorchecks your runtime environmentConversion report — opt-in JSON report with per-file diagnostics, including attachment referenced/retained counts for automation and audit
MCP server — integrate with Claude Desktop, Claude Code, Codex, and other MCP clients
Claude plugin — one-command install in Claude Code or Cowork with four slash commands (
/dead-letter:convert,/dead-letter:summarize,/dead-letter:triage,/dead-letter:cabinet)Python API —
from dead_letter import convertand you're off
Related MCP server: DingusMail
🧠 Built for LLM Pipelines
Raw .eml files are noisy input for downstream LLM and retrieval pipelines — MIME headers, multipart boundaries, duplicated HTML/plain bodies, and encoded attachments all get mixed into the text path.
dead-letter normalizes that into Markdown with YAML front matter, so message text and metadata are ready for chunking or indexing without MIME parsing or base64 cleanup. Default convert() and convert_dir() runs write a single .md per message and keep attachment names in front matter.
If you want the filesystem artifacts separated too, bundle and Cabinet workflows write message.md plus retained decoded files under attachments/. The Markdown is ready for text ingestion, while PDFs, spreadsheets, calendar files, and other retained binary attachments stay cleanly split out for whatever downstream parser you already use.
For direct LLM integration, the MCP server lets Claude Desktop, Claude Code, Codex, and other MCP clients call dead-letter's conversion tools without shelling out.
📊 Token-cost benchmarks
dead-letter's value isn't fewer tokens than every alternative — it's fidelity per token: the cheapest representation that keeps the email intact. Measured across a synthetic corpus of HTML threads, attachments, and newsletters (tokenizer o200k_base, medians):
~88% fewer tokens than the raw
.eml— a single email with a PDF attachment is ~126k tokens raw vs ~180 converted.The only representation that keeps the email whole — thread structure, per-message sender attribution, links, and attachment metadata all survive. Naive text extraction is cheaper precisely because it drops them (0/2 attachments retained vs dead-letter's 2/2).
The benchmark is honest about where it loses: naive extraction is fewer tokens when you don't mind throwing away attachments, links, and thread structure. Full method, the complete table (including those rows), tokenizer disclosure, and a one-command reproduce are in benchmarks/.
📦 Install
With Homebrew on Apple silicon macOS:
brew tap BigCactusLabs/tap
brew install dead-letterThe Homebrew formula installs the core CLI only: dead-letter convert and
dead-letter doctor. It intentionally does not bundle the optional web UI or
MCP server dependency stacks.
With 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 serverUse pipx for isolated UI or MCP installs:
pipx install 'dead-letter[ui]' # installs dead-letter and dead-letter-ui
pipx install 'dead-letter[mcp]' # installs dead-letter and dead-letter-mcpFrom source:
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🚀 Quick Start
CLI — convert a single file:
dead-letter convert message.emlConvert a whole directory:
dead-letter convert inbox/ --output out/Generate a JSON conversion report alongside the output:
dead-letter convert inbox/ --output out/ --reportWith --output, the report is written to that output directory as
.dead-letter-report.json. Without --output, file conversions write the
report next to the source message and directory conversions write it to the
input directory root.
Check your runtime environment:
dead-letter doctorDirectory conversion scans recursively for .eml files, matches the suffix
case-insensitively, skips symlinked files whose resolved targets escape the
requested input tree, and deduplicates in-tree symlink aliases that resolve to
the same message file.
Web UI — start the local server:
dead-letter-ui --host 127.0.0.1 --port 8765Open http://127.0.0.1:8765 — on first launch, a setup prompt suggests default Inbox and Cabinet folders. Configure or skip to start converting. Import .eml files with drag and drop or the file picker. Single-file imports use file mode, while multi-file drops create one directory-mode batch job. Mixed drops ask for confirmation before skipping non-.eml files.
The backend enforces a 100 MB per-file import limit for both single and batch
uploads.
From a source checkout, prefix with 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 .mdWith options:
from dead_letter import convert, ConvertOptions
result = convert("message.eml", options=ConvertOptions(
strip_signatures=True,
strip_quoted_headers=True,
))Strip signature images (logos, social icons) and tracking pixels:
result = convert("message.eml", options=ConvertOptions(
strip_signature_images=True,
strip_tracking_pixels=True,
))When enabled, these filters remove matched images from rendered Markdown and omit stripped inline signature/tracking assets from bundle attachment output.
Bundle conversion (Markdown + attachments + source in one directory):
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" preserves the original .eml in place. If omitted,
convert_to_bundle() defaults to source_handling="move" and moves the source
message into the bundle.
Retained extracted attachment filenames are normalized to safe basenames before
they are written under attachments/.
Quality diagnostics include referenced/retained attachment counts when a message has attachments eligible for retention, so dropped artifacts are machine-detectable. See Quality Diagnostics.
Batch:
from dead_letter import convert_dir
for r in convert_dir("inbox/", output="out/"):
print(f"{'✓' if r.success else '✗'} {r.source.name}")🔌 MCP Server
dead-letter ships an MCP server so LLM clients can convert .eml files directly without shelling out.
Install and launch:
pip install dead-letter[mcp]
dead-letter-mcpFrom a source checkout:
uv run --extra mcp dead-letter-mcpClaude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"dead-letter": {
"command": "uv",
"args": ["--directory", "/path/to/dead-letter", "run", "--extra", "mcp", "dead-letter-mcp"]
}
}
}Claude Code or Cowork (recommended — Claude plugin):
/plugin marketplace add BigCactusLabs/bigcactuslabs-plugins
/plugin install dead-letterThe plugin bundles the MCP server (via uvx, no pip install needed — just uv on PATH) and adds four slash commands: /dead-letter:convert, /dead-letter:summarize, /dead-letter:triage, /dead-letter:cabinet. Email content handled through the plugin is treated as untrusted data, not instructions, so tool-use, credential, and exfiltration requests embedded in messages are not followed. Source under plugin/.
The marketplace pins each published plugin tag and commit. Release automation updates that pointer only after the bundled MCP server's exact PyPI version is live, so Claude Code and Cowork resolve the same reproducible release.
Claude Code (manual MCP add — alternative):
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 listThe codex mcp add command registers the local dead-letter MCP server, and codex mcp list verifies that it's available.
Tools
Tool | Required arguments | Returns |
|
| Markdown text. Also writes a file when |
|
| JSON with |
|
| JSON summary. Capped at 50 |
|
| Quality and structure JSON. Writes nothing permanent. |
All four take a preset (default, clean, verbose, raw) and per-flag overrides. Full contract, including the MCP-only constraints and the error-text table: docs/reference/v4-runtime-contracts.md.
🗂 Project Structure
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🧪 Testing
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 runs all four on PRs and on pushes to main or feat/** branches with the
same commands, plus
npx --yes @anthropic-ai/claude-code@2.1.145 plugin validate plugin/ and
node --check src/dead_letter/frontend/static/app.js.
📚 Docs
Docs Index — public docs landing page
Runtime Contracts — full API and core behavior spec
Agent Guide — operational guide for AI coding agents working in this repo
🔧 Tools We Love
MarkEdit — TextEdit for Markdown, native macOS, ~4 MB. Opens dead-letter output like it was always meant to live there.
mo — local Markdown viewer that renders files in the browser with live reload. Point it at your Cabinet and read converted mail like a feed.
⚠️ Known Limitations
Local-only — no remote server, no auth
In-memory job registry (state resets on restart)
Single-user, single-machine
License
PolyForm Noncommercial 1.0.0 — free for personal, educational, and nonprofit use. Commercial use requires a separate license from 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