Connect MultiMail to Warp Terminal for AI Email

Add email capabilities to Warp's built-in AI agent through MCP. Send, read, and manage email directly from your terminal.


Warp is a modern, GPU-accelerated terminal with a built-in AI agent that supports MCP servers. By connecting MultiMail, Warp's AI agent can handle email operations alongside your command-line workflows — sending deployment notifications, reading support emails, or managing contacts without opening a browser.

MCP servers in Warp are configured in ~/.warp/mcp.json using the standard MCP JSON format. The setup is straightforward: add the MultiMail server config, and Warp's AI agent automatically picks up the email tools. Warp supports stdio transport, which is what MultiMail uses.

This integration is ideal for DevOps engineers and terminal-centric developers who want to manage email as part of their CLI workflow. Combine Warp's blocks, workflows, and collaborative features with MultiMail's email tools for a unified terminal experience.

Get started

1

Get your MultiMail API key

Sign up at multimail.dev and create an API key from your dashboard. This key authenticates all MCP server requests.

2

Create an agent mailbox

In the MultiMail dashboard, create a mailbox for Warp's AI agent to use. Set oversight to gated_send so all outbound emails require your approval.

3

Create the MCP config file

Create or edit the file at ~/.warp/mcp.json and add the MultiMail MCP server configuration.

json
{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_your_key_here"
      }
    }
  }
}
4

Restart Warp

Restart Warp to load the new MCP configuration. Warp reads the mcp.json file on startup and connects to configured servers.

5

Verify the connection

Open Warp's AI agent panel and ask it to list your mailboxes. If configured correctly, you'll see your MultiMail mailboxes returned in the agent's response.


Available MCP tools

ToolDescriptionExample
send_emailSend an email from your agent mailbox to any recipient.Send a deployment completion email after running your deploy script.
reply_emailReply to a received email, maintaining the thread context.Reply to an incident report email with the CLI commands you ran to fix it.
check_inboxCheck a mailbox for new or unread messages.Check for new alerts or notifications between terminal tasks.
read_emailRead the full content of a specific email including headers and body.Read a server alert email to understand what triggered the notification.
create_mailboxCreate a new agent mailbox on your MultiMail account.Create a mailbox for infrastructure alerts and notifications.
list_mailboxesList all mailboxes on your MultiMail account.View available mailboxes to select the right sender for ops emails.
get_threadRetrieve an entire email thread to see the full conversation history.Review the full incident response thread before sending a resolution.
search_contactsSearch your contact list by name, email, or tags.Find the on-call engineer's email to send them server logs.
add_contactAdd a new contact to your MultiMail contact list.Add a new team member's email for future notifications.
tag_emailTag or categorize an email for organization and filtering.Tag incident emails with severity levels for post-mortem reviews.
list_pendingList all emails currently awaiting human approval.Review queued notification emails before approving them.
decide_emailApprove or reject a pending email in the oversight queue.Approve an incident resolution email after verifying the fix.

Usage examples

Warp MCP configuration
json
{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_your_key_here"
      }
    }
  }
}

Add this to ~/.warp/mcp.json to connect MultiMail to Warp.

Post-deployment email workflow
text
I just deployed the latest changes to production using 'git push production main'. Send an email to [email protected] with the subject 'Production Deployment Complete' listing the last 5 commit messages.

Ask Warp's AI to send a deployment notification after running commands.

Incident response email
text
I ran 'kubectl get pods' and several pods are in CrashLoopBackOff. Check my MultiMail inbox for related alert emails, then send an incident report to [email protected] with the pod status and any relevant alert details.

Use Warp's AI to compose an incident email based on terminal output.

Multiple MCP servers in Warp
json
{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_your_key_here"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

Combine MultiMail with other MCP servers in Warp.


Best practices

Combine with Warp Workflows

Create Warp Workflows that include email steps. For example, build a deployment workflow that runs your deploy commands, then asks the AI agent to email the team a summary. Workflows make complex multi-step processes repeatable.

Use Warp Blocks for email context

Warp's Blocks feature groups command output into logical units. Reference specific block output when asking the AI to compose emails. For example, 'send the output from the last test run block to [email protected]'.

Terminal-native email triage

Warp's AI agent can check your inbox, summarize emails, and help you respond without switching to a browser. This is especially useful during on-call rotations or when monitoring deployments, keeping all your operational context in one terminal.

macOS and Linux only

Warp is currently available on macOS and Linux. If you need a terminal with MCP support on Windows, consider using Claude Code (Anthropic's CLI) which supports MCP servers and runs on all platforms.


Common questions

Where does Warp store MCP configuration?
Warp reads MCP server configuration from ~/.warp/mcp.json on both macOS and Linux. This file uses the standard MCP JSON format with a mcpServers key. Create the file if it doesn't exist, and restart Warp to load changes.
Can I use Warp's AI agent for email without leaving the terminal?
Yes, that's the primary benefit. Warp's AI agent can access all MultiMail tools directly. You can check your inbox, read emails, compose replies, and manage contacts without switching to a browser or email client. The AI agent processes everything within Warp's interface.
Does Warp support SSE transport for MCP?
Warp currently supports stdio transport for MCP servers. The MultiMail MCP server uses stdio, so it works natively with Warp. If you need SSE transport for other MCP servers, check Warp's latest release notes for updates on transport support.
Can I share the MCP config with my team via Warp Teams?
Warp Teams supports shared workflows and configurations, but MCP server configs contain API keys that should be per-user. Share the config structure with your team as a template, and have each member add their own MultiMail API key. Never share API keys through team configurations.
Is Warp available on Windows?
Warp is currently available on macOS and Linux. Windows support is not yet available. If you need terminal-based MCP support on Windows, Claude Code (Anthropic's CLI) is an alternative that supports MCP servers and works on Windows, macOS, and Linux.

More MCP clients

The only agent email with a verifiable sender

Email infrastructure built for AI agents. Verifiable identity, graduated oversight, and a 38-tool MCP server. Formally verified in Lean 4.