voidmail

@voidly/mcp-email

Email for AI agents. One API call, instant inbox. No phone number, no CAPTCHA.

Install

npx @voidly/mcp-email

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "voidmail": {
      "command": "npx",
      "args": ["-y", "@voidly/mcp-email"],
      "env": {
        "VOIDMAIL_API_KEY": "vm_your_key_here"
      }
    }
  }
}

No API key yet? The agent can create one with voidmail_create_account.

Quick Start

Step 1 — Create an inbox: `` Use the voidmail_create_account tool to create an email inbox ``

Step 2 — Send email: `` Use voidmail_send_email to send an email to user@example.com ``

Step 3 — Check inbox: `` Use voidmail_list_inbox to see received emails ``

Tools (13)

| Tool | Description | |------|-------------| | voidmail_create_account | Create a new @voidmail.ai inbox (returns address + API key) | | voidmail_account_info | Get account details | | voidmail_list_inbox | List emails with pagination and filters | | voidmail_read_email | Read a specific email (auto-marks as read) | | voidmail_search_inbox | Full-text search across subject, body, sender | | voidmail_send_email | Send email from agent's @voidmail.ai address | | voidmail_mark_read | Mark email as read | | voidmail_delete_email | Delete email | | voidmail_create_alias | Create disposable email alias | | voidmail_list_aliases | List all aliases | | voidmail_delete_alias | Remove alias | | voidmail_set_webhook | Get notified on new email (HTTPS webhook) | | voidmail_get_stats | Inbox statistics |

Resources (3)

| Resource | URI | Description | |----------|-----|-------------| | Inbox | email://inbox | Current inbox contents | | Aliases | email://aliases | Active email aliases | | Stats | email://stats | Account statistics |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | VOIDMAIL_API_KEY | No | API key from create_account (persists across sessions) | | VOIDMAIL_ADDRESS | No | Your @voidmail.ai address |

REST API

Use directly without MCP:

# Create inbox
curl -X POST https://api.voidly.ai/v1/agent-mail/create \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent"}'

# List inbox
curl https://api.voidly.ai/v1/agent-mail/inbox \
  -H "X-Agent-Mail-Key: vm_your_key"

# Send email
curl -X POST https://api.voidly.ai/v1/agent-mail/send \
  -H "X-Agent-Mail-Key: vm_your_key" \
  -H "Content-Type: application/json" \
  -d '{"to":"user@example.com","subject":"Hello","text":"From my agent"}'

# Search
curl "https://api.voidly.ai/v1/agent-mail/inbox/search?q=invoice" \
  -H "X-Agent-Mail-Key: vm_your_key"

Why Voidmail?

| | Voidmail | AgentMail | Gmail MCP | |---|---------|-----------|-----------| | Agent-native inbox | Yes | Yes | No (proxy) | | No phone/CAPTCHA | Yes | Yes | No | | E2E encryption option | Yes | No | No | | MCP server | Yes | No | Yes | | Free tier | Unlimited | 3 inboxes | N/A | | Open protocol | Yes | No | No |

Links

• API docs: https://voidly.ai/api-docs
• Landing page: https://voidly.ai/veil
• Privacy: https://voidly.ai/c/privacy
• Support: support@voidly.ai

License

MIT