@voidly/mcp-email

@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 [e-mail]

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":"[e-mail]","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: [e-mail]

License

MIT