Voidmail Agent Email MCP Server

Email for AI agents. Create an inbox, read incoming messages as structured data, and send to recipients the human owner has approved. No phone number or CAPTCHA.

Local serverstdioMIT

What is the Voidmail Agent Email MCP Server?

mcp-email is an MCP project maintained in the voidly-ai/mcp-email repository. The maintainer describes its purpose as “Email for AI agents. Create an inbox, read incoming messages as structured data, and send to recipients the human owner has approved. No phone number…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @voidly/mcp-email. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
voidmail_create_accountCreate a new @voidmail.ai inbox; saves both keys to 0600 files and returns only their paths
voidmail_account_infoGet account details
voidmail_list_inboxList emails with pagination and filters
voidmail_read_emailRead a specific email (auto-marks as read)
voidmail_search_inboxFull-text search across subject, body, sender
voidmail_sending_limitsRead sending policy without consuming send capacity
voidmail_send_onceSend one authorized message with a saved operation ID and retained status
voidmail_send_statusRead the same original send without sending again
voidmail_send_emailLegacy send without durable status; prefer voidmail_send_once
voidmail_policyRead the recipient and content policy, approved recipients and pending requests
voidmail_request_recipientAsk the owner to approve a recipient; returns the approval step
voidmail_revoke_recipientRemove an approved recipient (restricting needs no owner)
voidmail_mark_readMark email as read
voidmail_delete_emailDelete email
voidmail_create_aliasCreate disposable email alias
voidmail_list_aliasesList all aliases
voidmail_delete_aliasRemove alias
voidmail_set_webhookSet an HTTPS webhook on an open-policy inbox; allowlist inboxes require the human owner to use POST /v1/agent-mail/owner/webhook with the owner key
voidmail_get_statsInbox statistics

How to install the Voidmail Agent Email MCP Server

{
  "mcpServers": {
    "voidmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@voidly/mcp-email@1.2.1"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.