NewModel Context Protocol

Talk to your email aliases

The official EmailAlias.io MCP server lets Claude Desktop, Cursor, Zed, and every other MCP-compatible AI assistant manage your aliases in plain English.

View on GitHub Set up in 2 minutes

What it looks like in practice

Real prompts, answered with real tool calls.

You

Create a disposable alias for signing up to Substack, label it "newsletter".

You

Disable the amazon alias, I'm getting too much spam on it.

You

Show me aliases that got zero emails in the last 30 days.

You

Which aliases were flagged for suspicious senders this week?

You

Send a reply from my work-signup alias thanking them for the demo.

Install

The MCP server runs locally on your machine. It calls the EmailAlias REST API over HTTPS using your personal API key.

Create an API key

In the dashboard, go to Settings → API Keys → Create. Copy the key immediately — it's shown once.

API keys are a Premium feature.

Add the MCP server to your client's config

macOS Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "emailalias": {
      "command": "npx",
      "args": ["-y", "@emailalias/mcp"],
      "env": {
        "EMAILALIAS_API_KEY": "ea_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Windows config lives at %APPDATA%\Claude\claude_desktop_config.json. Linux: ~/.config/Claude/claude_desktop_config.json.

Restart your client and start chatting

In Claude Desktop you'll see a 🔌 plug icon confirming the server is connected. Ask anything from the prompts above, or start with “list my aliases.”

Works with every MCP client

MCP is an open protocol — any client that speaks it can use the EmailAlias server without changes.

Claude Desktop

Cursor

Zed

Cline

VS Code (Continue)

Any MCP-compatible client

Available tools

The LLM decides which of these to call based on your request. Descriptions here mirror what the model sees.

list_aliases

Every alias with forwarded / blocked counts.

create_alias

Random, custom, or tagged alias in one call.

update_alias

Toggle active, rename the label.

delete_alias

Permanently remove an alias.

list_available_domains

System and verified custom domains.

list_destinations

Primary + verified forwarding inboxes.

add_destination

delete_destination

Remove a destination (blocked if in use).

send_email

Send outbound mail from any alias (Premium).

get_dashboard_stats

Account-wide counters at a glance.

list_email_logs

Paginated forwarding log, last 90 days.

list_exposure_events

Suspicious-sender alerts.

Security

Your API key never leaves your machine

The server runs locally as a subprocess of your MCP client, talks to the EmailAlias API over HTTPS directly, and sends the key only in that request. No third-party relay.

Destructive tools prompt before firing

Claude Desktop and most MCP clients ask for explicit confirmation before running tools that mutate state (create_alias, delete_alias, send_email, etc.). Review what the model proposes.

Keys rotate like any API key

Lost your machine? Delete the key from Settings → API Keys. Every running MCP server using it stops working immediately.

Ready to plug in?

Open-source, MIT-licensed, and shipped via npm. Takes two minutes to set up.

emailalias-mcp on GitHub API docs