MCP · v0.9 An email server that speaks Model Context Protocol

Give your agent an inbox, not another API key.

MCPMail is a hosted MCP server that lets agents send and receive real email — on your domain, or on a shared one we run. No OAuth dance. No brittle IMAP glue. Just send_mail, list_inbox, reply.

Claim a mailbox Read the protocol
$ npx mcpmail connect agent@yours.com
SETUP
~60 sec
from claim to first send
DELIVERABILITY
DKIM · SPF · DMARC
signed automatically
INTERFACE
9 MCP tools
read, write, thread, attach
agent.session
tools
log
claude · mcpmail
userCheck if the catering vendor replied, and confirm Thursday.
agentmcpmail.list_inbox from:catering* limit:5
→1 match · “Re: Thursday lunch — quote” · 2h ago
agentmcpmail.read_thread id:t_8fD2
agentmcpmail.reply id:t_8fD2 draft:true
→draft saved · d_44Ka
agentmcpmail.send draft:d_44Ka
→queued · signed (DKIM) · delivered in 1.2s
$
ada@acme.co · inbox (3 unread) mcpmail://mailbox/ada
Mailboxes
Inbox12
Drafts (agent)2
Sent48
Archive—
Rules
from:finance*auto
subject:invoicetag
Parkside Catering agent-replied
Re: Thursday lunch — quote & allergen list
2h
Stripe
Payout of $2,418.00 to ••4432 completed
6h
n.chen@supplier.io
Shipment ETA · PO-10492 moved to Fri 26
Tue
careers@acme.co forwarded
Fwd: Application — Staff Eng (agent screened)
Mon
01  /   Two ways to run it

Bring your own domain, or borrow ours for the afternoon.

A · Custom domain

Your agent at @yours.com

Point MX at MCPMail, paste the DKIM record, and every mailbox on your domain becomes a first-class agent endpoint. Humans and agents share the same infra.

ada@acme.co support@acme.co billing-bot@acme.co
  1. 01Add MX + TXT records (we give you the exact lines)
  2. 02Create a mailbox, assign an agent key or a human login
  3. 03Connect via MCP — send, receive, thread
  4. 04Outbound signed with DKIM/SPF/DMARC. TLS on by default.
B · Shared domain

Instant inbox at @mcpmail.bot

Prototyping, or an agent that doesn’t need its own brand on the From line? Claim a handle and start sending in about a minute. Upgrade to a custom domain whenever.

ada-7f2@mcpmail.bot triage@mcpmail.bot scout@mcpmail.bot
  1. 01Run npx mcpmail claim — pick a handle
  2. 02We print a config block; paste into your MCP client
  3. 03Agent can send and receive immediately
  4. 04Rate-limited to keep the shared domain reputable
02  /   The protocol

Nine small tools. Everything an agent needs to live in email.

Tool What it does Returns
→send_mailCompose and send a new message. Accepts markdown, plain, or mime parts.message_id, delivery status
→replyReply in-thread, preserving references and subject threading.message_id, thread_id
→list_inboxFilter by sender, subject, label, or time window. Cursor-paginated.message[], cursor
→read_threadFetch a full conversation with inline attachments resolved to refs.thread, messages[]
→searchFull-text query across mailbox with operators (from:, has:, before:).message[], highlights
→attachUpload or reference a file as an attachment, including signed URLs.attachment_id
→labelApply labels, archive, mark read / unread, snooze until timestamp.ok, mutated_ids[]
→wait_for_replyLong-poll a thread; resolves when a new message lands or timeout.message | timeout
→on_messageRegister a webhook / MCP event stream for incoming mail.subscription_id
03  /   Connect in 8 lines

Drop it into any MCP client. We keep the boring parts boring.

~/.config/mcp/servers.json json 
// Add MCPMail to any client that speaks MCP.
{
  "mcpServers": {
    "mail": {
      "command": "npx",
      "args": ["-y", "@mcpmail/server"],
      "env": {
        "MCPMAIL_MAILBOX": "ada@acme.co",
        "MCPMAIL_KEY":     "mk_live_••••••••••••"
      }
    }
  }
}
SOC 2 Type II (in progress)
SPF · DKIM · DMARC signed
Scoped, revocable agent keys
Per-tool audit log, exportable
04  /   Pricing

Free to try. Priced per mailbox, not per message.

Hobby
$0/mo
For prototyping on our shared domain.
  • 1 mailbox on @mcpmail.bot
  • 500 sends / month
  • Unlimited inbound
  • All 9 MCP tools
  • Community support
Claim a handle
Team · popular
$12/ mailbox / mo
Custom domain, agent + human mailboxes, real deliverability.
  • Up to 25 mailboxes
  • Bring your own domain
  • 25k sends / month pooled
  • DKIM/SPF/DMARC automation
  • Audit log + webhooks
  • Email support
Start 14-day trial
Scale
Custom
Dedicated IP pools, SSO, data residency, and volume.
  • Unlimited mailboxes
  • Dedicated IPs + warmup
  • SAML SSO, SCIM
  • EU / US data residency
  • 99.95% uptime SLA
  • Shared Slack channel
Talk to us
05  /   Get started

Your agent has something to say. Let it hit send.

Claim a mailbox Read the docs v0.9 · public beta · free while in beta
© 2026 MCPMail Labs Built for agents. Still good for humans.