Voidmail

FreeNot checked

Email for AI agents. Create inboxes, send and receive emails without phone or CAPTCHA.

by voidly-ai

GitHub Embed

About

Email for AI agents. Create inboxes, send and receive emails without phone or CAPTCHA.

README

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 [email protected]

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":"[email protected]","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

License

MIT

from github.com/voidly-ai/mcp-email

Install Voidmail in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install voidmail

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add voidmail -- npx -y @voidly/mcp-email

FAQ

Is Voidmail MCP free?

Yes, Voidmail MCP is free — one-click install via Unyly at no cost.

Does Voidmail need an API key?

No, Voidmail runs without API keys or environment variables.

Is Voidmail hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Voidmail in Claude Desktop, Claude Code or Cursor?

Open Voidmail on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Gmail

Read, send and search emails from Claude

by Google

Slack

Send, search and summarize Slack messages

by Slack

Runbear

No-code MCP client for team chat platforms, such as Slack, Microsoft Teams, and Discord.

by Community

Discord Server

A community discord server dedicated to MCP by [Frank Fiegel](https://github.com/punkpeye)