How to Export Emails

Save individual emails, batches, or entire conversation threads to disk in various formats for archiving, analysis, or migration.

Export a Single Email

“Export that email as markdown”

tool: export
params:
  target: "message"
  id: "AAMkAGR..."
  format: "markdown"
  savePath: "/tmp/email-export.md"

Export as EML (For Archiving)

EML is the standard email archive format, importable into any email client:

tool: export
params:
  target: "message"
  id: "AAMkAGR..."
  format: "eml"
  savePath: "/tmp/email.eml"

Export a Full Conversation Thread

“Export the entire thread about the contract review”

tool: export
params:
  target: "conversation"
  conversationId: "AAQkAGR..."
  format: "markdown"
  outputDir: "/tmp/contract-thread/"

Control message order:

tool: export
params:
  target: "conversation"
  conversationId: "AAQkAGR..."
  format: "mbox"
  outputDir: "/tmp/contract-thread/"
  order: "chronological"

Batch Export Multiple Emails

Export a list of specific emails:

tool: export
params:
  target: "messages"
  emailIds: ["AAMkAGR1...", "AAMkAGR2...", "AAMkAGR3..."]
  format: "markdown"
  outputDir: "/tmp/batch-export/"

Or export emails matching a search query:

tool: export
params:
  target: "messages"
  searchQuery:
    from: "finance@company.com"
    receivedAfter: "2026-01-01"
    maxResults: 50
  format: "json"
  outputDir: "/tmp/finance-export/"

Export as CSV (For Spreadsheets)

CSV exports email metadata (subject, from, to, dates) without body content — ideal for importing into Excel or Google Sheets:

tool: export
params:
  target: "messages"
  searchQuery:
    from: "finance@company.com"
    receivedAfter: "2026-01-01"
  format: "csv"
  outputDir: "/tmp/finance-audit/"

Batch CSV exports produce a single aggregated file with one row per email. CSV values are protected against formula injection (OWASP mitigation).

Get Raw MIME Content

For developers or forensic analysis:

tool: export
params:
  target: "mime"
  id: "AAMkAGR..."

Choose the Right Format

Format	Best for	File type
markdown	Reading, sharing, AI processing	.md
eml	Archiving, importing to other clients	.eml
mbox	Bulk archiving (one file, many messages)	.mbox
json	Programmatic processing, data analysis	.json
html	Viewing in a browser with formatting	.html
csv	Spreadsheet import, bulk metadata analysis	.csv
mime	Raw email content, forensics	raw output

Parameter Reference

Parameter	What it does	Used with
target	message, messages, conversation, or mime	All
id	Email ID	message, mime
format	Output format (see table above)	message, messages, conversation
savePath	File path for single export	message
outputDir	Directory for batch/thread export	messages, conversation
emailIds	Array of email IDs	messages
searchQuery	Search criteria for batch export	messages
conversationId	Thread ID	conversation
order	chronological or reverse	conversation
includeAttachments	Include attachments	message (default: true)

Tips

• Use markdown format for AI-readable exports
• Use csv format to get email metadata into a spreadsheet for analysis
• Use mbox for archiving entire conversations in a single file
• Combine with search-emails to find emails first, then export the IDs
• The searchQuery option in batch mode saves a step — no need to search first

Related

• Find Emails — search for emails to export
• Read Email Threads — read before exporting
• Work with Attachments — download attachments separately
• Tools Reference — export