AI IntegrationBuilt for Claude, Cursor & the MCP ecosystem

Your inbox, on autopilot

Spin up disposable aliases, kill spam-magnets, and audit forwarded mail by chatting with your AI assistant. The EmailAlias MCP server drops into Claude Desktop, Cursor, Zed, Cline, and every MCP-compatible client — no dashboard hunting, no copy-paste.

View on GitHubSet up in 2 minutes

See it in action

Real prompts, real tool calls, real answers — in your AI assistant of choice.

emailalias · Claude Desktopconnected

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

You

Done. x7k9m@email91.com is live and forwarding to your primary inbox.

create_alias

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

You

Disabled. Incoming mail to that alias will silently bounce until you re-enable it.

update_alias

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

You

Found 4: shopping-target, retro-forum, devmeetup-2024, conf-rsvp.

list_aliaseslist_email_logs

Which aliases were flagged for suspicious senders this week?

You

2 alerts — gaming-trial (.xyz typo-domain) and travel-deals (phishing pattern).

list_exposure_events

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

You

Sent. The recipient sees the reply coming from your alias, not your real address.

send_email
Ask anything…

Install

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

1

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.

2

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.

3

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

Register a new forwarding address.

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 GitHubAPI docs