Give your agent
full email capabilities

40 tools. One MCP server. Every email operation your agent needs — send, receive, reply, manage contacts, handle approvals. Works with Claude, Cursor, and any MCP client.

Install MCP Server →

or run npx @multimail/mcp-server

Setup

Connected in 30 seconds

Two options. The remote server needs zero install — just paste the URL. The local server runs via npx. Pick whichever fits your workflow.

Remote server (recommended)

No install. No dependencies. Connect directly to our hosted MCP server at mcp.multimail.dev. Authenticates via OAuth in the browser — paste your API key once. Works with Claude.ai, Claude Desktop, Claude Code, and any client that supports remote MCP.

Local server (stdio)

Run the server locally via npm. Your API key is passed as an environment variable. Package: @multimail/mcp-server on npm.

Set MULTIMAIL_MAILBOX_ID to skip the list_mailboxes step. Set MULTIMAIL_API_URL to point at a local dev server.

Remote — claude_desktop_config.json
{ "mcpServers": { "multimail": { "type": "url", "url": "https://mcp.multimail.dev/mcp" } } }
Local — claude_desktop_config.json
{ "mcpServers": { "multimail": { "command": "npx", "args": ["-y", "@multimail/mcp-server"], "env": { "MULTIMAIL_API_KEY": "mm_live_...", "MULTIMAIL_MAILBOX_ID": "01KJ1..." } } } }
37 Tools

Everything an agent needs for email

Not a wrapper around SMTP. A complete email toolkit designed for agents — inboxes, contacts, approvals, webhooks, billing, all of it.

Mailbox Management
create_mailbox
Create a new mailbox with custom address and oversight mode
list_mailboxes
List all mailboxes with IDs, addresses, and settings
update_mailbox
Change display name, oversight mode, webhooks, signature
delete_mailbox
Permanently delete a mailbox and all its data
Email Operations
send_email
Send email with markdown body, attachments, CC/BCC
reply_email
Reply in-thread with automatic threading headers
read_email
Get full email content as markdown with metadata
check_inbox
Filter inbox by status, sender, date, direction
get_thread
Get all emails in a conversation, chronologically
tag_email
Set, get, or delete key-value tags on emails
cancel_message
Cancel a pending email before it sends
download_attachment
Download attachment as base64 from any email
Contact Management
add_contact
Add a contact with name, email, and tags
delete_contact
Remove a contact from the address book
search_contacts
Search by name or email with partial matching
 
Approval Queue
list_pending
List emails awaiting operator approval
decide_email
Approve or reject a pending email with reason
Account & Billing
get_account
Account status, plan, quotas, enforcement tier
update_account
Update operator name, oversight email, address
activate_account
Activate with confirmation code from email
delete_account
Permanently delete account and all data
get_usage
Check quota, emails sent/received, storage used
get_audit_log
Account audit log with all actions and timestamps
create_api_key
Create a scoped API key (key shown once)
list_api_keys
List all API keys with metadata
revoke_api_key
Revoke an API key permanently
resend_confirmation
Resend operator activation email
request_upgrade
Request oversight mode upgrade from operator
apply_upgrade
Apply upgrade code to change oversight mode
Webhooks & Deliverability
create_webhook
Subscribe to email events with HTTPS endpoint
list_webhooks
List all webhook subscriptions
delete_webhook
Remove a webhook subscription
wait_for_email
Block until email arrives or timeout (5–120s)
check_suppression
List suppressed email addresses
remove_suppression
Remove address from suppression list
How it works

Three steps to agent email

No SMTP servers. No MIME parsing. No HTML templates. Your agent writes markdown; recipients get formatted email.

1

Install the server

Add the MCP config to Claude Desktop or any MCP client. Remote server needs zero install. Local server runs via npx @multimail/mcp-server.

2

Connect your API key

Sign up at multimail.dev/dashboard, get your API key, and paste it into the config. Your agent has a real email address immediately.

3

Your agent has email

Send, receive, reply, manage contacts, handle attachments. All 40 tools are available. Your agent picks the right one.

Example conversation with Claude
User: Check my inbox for anything from Sarah and summarize it. Claude: I'll check your inbox now. [check_inbox sender="sarah" status="unread"] Found 2 unread emails from Sarah Chen. Let me read them. [read_email email_id="em_8f2k..."] [read_email email_id="em_9a3j..."] Here's the summary: 1. Q1 budget review — needs your sign-off by Friday 2. Team offsite dates — proposing March 18-20, wants your preference User: Reply to the budget one. Tell her I'll review it tomorrow. Claude: [reply_email email_id="em_8f2k..."] Done. Reply sent (held for your approval since this mailbox uses gated_send mode). Check your oversight email to approve.
Oversight built in

Your agent reads freely. Sends go through you.

Every mailbox has an oversight mode. Start restrictive, loosen as you build trust. The agent earns autonomy — it doesn't start with it.

read_only
Agent can receive and read email. Cannot send. Training wheels.
gated_all
Both inbound and outbound require human approval before delivery.
gated_send  (default)
Outbound emails held for approval. Inbound delivered immediately. The right starting point for most agents.
monitored
Agent sends freely. Copies go to oversight address. You see everything.
autonomous
Full send and receive. No approval gates. For agents that have earned trust.

The approval flow

When an agent sends from a gated mailbox, the email gets a 202 status instead of 200. It sits in the approval queue. The operator gets an email with one-click approve or reject.

The agent can check on pending messages with list_pending. Operators (or agents with oversight scope) can approve or reject with decide_email. Rejected messages never leave the system.

Upgrading oversight

An agent can request more autonomy with request_upgrade. This sends a code to the operator. The operator shares the code. The agent redeems it with apply_upgrade. No backdoors. The human always decides.

Install now

Give your agent email today

Free tier includes 2 mailboxes and 200 emails per month. No credit card required.

Quick start
# Remote (recommended — zero install) # Add to claude_desktop_config.json: { "mcpServers": { "multimail": { "type": "url", "url": "https://mcp.multimail.dev/mcp" } } } # Local (via npm) npx @multimail/mcp-server
npm: @multimail/mcp-server GitHub repo API documentation