MCP Server

Inbound’s MCP (Model Context Protocol) server lets AI assistants manage your domains, endpoints, addresses, emails and Guard rules. It can also create mailboxes: virtual email accounts that an agent can read, reply from and send from. Server URL: https://inbound.new/mcp

Connect

With OAuth (recommended)

Add the URL to your client. When it connects, it opens Inbound in your browser; sign in and approve access. No API key needed.

claude mcp add --transport http inbound https://inbound.new/mcp

{
  "mcpServers": {
    "inbound": { "type": "http", "url": "https://inbound.new/mcp" }
  }
}

{
  "mcp": {
    "inbound": { "type": "remote", "url": "https://inbound.new/mcp" }
  }
}

In Claude.ai and ChatGPT, add a custom connector with the same URL. OAuth grants full access to your account, the same as an API key. The approval screen names the app and where it will send you back to; only approve apps you started the connection from.

With an API key

For scripts and clients without OAuth, send an API key from settings as a bearer token:

{
  "mcpServers": {
    "inbound": {
      "type": "http",
      "url": "https://inbound.new/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

The x-inbound-api-key header also works. Clients that only support STDIO can bridge with npx mcp-remote https://inbound.new/mcp --header "Authorization:Bearer ${INBOUND_API_KEY}".

Give an agent its own mailbox

Ask your assistant to create a mailbox, e.g. “Create a mailbox for agent@yourdomain.com called Support Agent”. This calls create_mailbox, which returns a password shown once.
Connect the agent to https://inbound.new/mcp with Authorization: Bearer <mailbox password>.
The agent now has one email account: it can check its inbox, read, reply, send and archive. It can’t see other mail in your account or send as any other address. The Inbound API enforces this.

The same mailbox password works over IMAP and SMTP, and the mailbox appears in the dashboard. The address must be on a verified domain; new accounts can use their instant *.inbnd.dev domain.

Mailbox tools

Tool	Description
`whoami`	The mailbox’s address, sending identity, scopes and unread count
`list_messages`	Inbox, archive or sent folder, with `unread_only` and search
`read_message`	Full message; marks it read
`update_message`	Mark read/unread, archive/unarchive
`get_thread`	The whole conversation
`reply`	Reply to a received message, threaded
`send_email`	Send a new email as the mailbox
`download_attachment`	Fetch an attachment

Account tools

Connected with OAuth or an API key, the server exposes 50 tools:

Area	Tools
Domains	`list_domains`, `get_domain`, `create_domain`, `update_domain`, `delete_domain`, `enable_domain_dkim`
Endpoints	`list_endpoints`, `get_endpoint`, `create_endpoint`, `update_endpoint`, `delete_endpoint`, `test_endpoint`
Addresses	`list_email_addresses`, `get_email_address`, `create_email_address`, `update_email_address`, `delete_email_address`
Emails	`list_emails`, `get_email`, `send_email`, `reply_to_email`, `update_email`, `cancel_scheduled_email`, `pause_scheduled_email`, `resume_scheduled_email`, `retry_email_delivery`, `list_threads`, `get_thread`, `list_attachments`, `download_attachment`
Mailboxes	`list_mailboxes`, `create_mailbox`, `update_mailbox`, `delete_mailbox`, `rotate_mailbox_password`, `get_mailbox`, `list_mailbox_messages`, `read_mailbox_message`, `update_mailbox_message`, `get_mailbox_thread`, `send_from_mailbox`, `reply_from_mailbox`, `download_mailbox_attachment`
Guard	`list_guard_rules`, `get_guard_rule`, `create_guard_rule`, `update_guard_rule`, `delete_guard_rule`, `check_guard_rule`, `generate_guard_rule`

To expose fewer tools, add ?toolsets= with any of domains,endpoints,addresses,emails,mailboxes,guard, for example https://inbound.new/mcp?toolsets=mailboxes,emails.

Example prompts

“Show me unread email to support@mydomain.com”
“Create a webhook endpoint for https://example.com/hooks and route orders@mydomain.com to it”
“Create a mailbox for agent@mydomain.com and give me its MCP config”
“Reply to the last email from jane@example.com saying we’ll ship Friday”
“Block cold sales outreach with a Guard rule”

The server is open source: inboundemail/mcp.

Quickstart

Mailboxes & SMTP

Integrations

Connect

With OAuth (recommended)

With an API key

Give an agent its own mailbox

Mailbox tools

Account tools

Example prompts

​Connect

​With OAuth (recommended)

​With an API key

​Give an agent its own mailbox

​Mailbox tools

​Account tools

​Example prompts

Connect

With OAuth (recommended)

With an API key

Give an agent its own mailbox

Mailbox tools

Account tools

Example prompts