Examples

Use these examples when you want a task-focused path instead of a conceptual reference page.

File and mailbox inputs

Files Ingest .eml files

Ingest one or more individual message files and export a stored message.

eml Archive Ingest an mbox archive

Parse a mailbox archive from disk and inspect the resulting documents.

mbox Mailbox Receive IMAP folders

Fetch selected live mailbox folders once or with foreground polling.

imap Gmail Receive Gmail messages

Authorize a read-only Gmail token and fetch messages into the local workspace.

receive Polling Watch Gmail receive

Run foreground Gmail polling and inspect one JSON line per receive pass.

watch

Export and send examples

Export Export formats

Export stored documents as JSON, Markdown, HTML, or PDF.

exports Send SMTP and Cloudflare sends

Use dry runs, provider credentials, attachments, idempotency keys, and audit records.

send Gmail Gmail OAuth send

Authorize a local Gmail sender and send through the Gmail API.

gmail

Integration examples

Python Python parse-only and storage-backed workflows

Use MailAtlas from application code, workers, notebooks, or tests.

python MCP Local MCP server

Expose local MailAtlas tools to MCP-compatible clients over STDIO.

mcp