Integration

Mailpit integration

Mailpit is a self-hosted SMTP test server that captures the mail an application sends so it can be inspected instead of delivered. This integration covers its v1 API: list, search and read captured messages with their headers, addresses, body and inline HTML, download the raw source or an attachment and its thumbnail, mark messages read or unread, tag them and rename or delete tags, delete messages one by one or by search query, release a captured message to real recipients through a configured SMTP relay, send a new message through Mailpit, run the built-in HTML compatibility, link and SpamAssassin checks on a message, read server information and the web UI configuration, and drive the Chaos failure-injection triggers. The host is part of the credential because every Mailpit install is its own deployment. Authentication is the optional HTTP basic auth Mailpit enforces when the instance is started with UI authentication.

Connect Mailpit How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Mailpit.Built from the 23 Mailpit tools below, on the connection you add once.

What you can do with Mailpit

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Message, 4 operations

delete_messagesDelete messagesDELETEDelete messages.
get_messageGet messageGETGet message summary.
list_messagesList messagesGETList messages.
set_messages_read_statusSet messages read statusPUTSet read status.

Tag, 4 operations

delete_tagDelete tagDELETEDelete a tag.
list_tagsList tagsGETGet all current tags.
rename_tagRename tagPUTRename a tag.
set_message_tagsSet message tagsPUTSet message tags.

Chao, 2 operations

get_chaos_triggersGet chaos triggersGETGet Chaos triggers.
set_chaos_triggersSet chaos triggersPUTSet Chaos triggers.

Search, 2 operations

delete_messages_by_searchDelete messages by searchDELETEDelete messages by search.
search_messagesSearch messagesGETSearch messages.

Header, 1 operation

get_message_headersGet message headersGETGet message headers.

Html check, 1 operation

check_message_htmlCheck message htmlGETHTML check.

Info, 1 operation

get_server_infoGet server infoGETGet application information.

Link check, 1 operation

check_message_linksCheck message linksGETLink check.

Part, 1 operation

download_message_attachmentDownload message attachmentGETGet message attachment.

Raw, 1 operation

download_message_sourceDownload message sourceGETGet message source.

Release, 1 operation

release_messageRelease messagePOSTRelease message.

Sa check, 1 operation

check_message_spam_scoreCheck message spam scoreGETSpamAssassin check.

Send, 1 operation

send_messageSend messagePOSTSend a message.

Thumb, 1 operation

download_attachment_thumbnailDownload attachment thumbnailGETGet an attachment image thumbnail.

Webui, 1 operation

get_web_ui_configGet web ui configGETGet web UI configuration.

Use Mailpit from Claude Code, Cursor or Codex

Connect Mailpit in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Mailpit operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Mailpit

Create your workspace
Sign up free. Nothing to install.
Connect Mailpit once
Add your Mailpit connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.