AI IntegrationBuilt for Claude, Cursor & the MCP ecosystem

Your inbox, on autopilot

Spin up private aliases, kill spam-magnets, and audit forwarded mail by chatting with your AI assistant. Drops into Claude Desktop, Cursor, Zed, and every MCP-compatible client via our open-source MCP server — and into ChatGPT via a Custom GPT.

See it in action

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

emailalias · Claude Desktopconnected

Create an 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

Claude · Cursor · Zed · Cline

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.”

Using ChatGPT?

Custom GPT · OpenAI Actions

ChatGPT doesn't run MCP servers natively the way Claude Desktop and Cursor do. The path there is OpenAI's “Actions” feature on a Custom GPT — it consumes our OpenAPI spec directly, no local subprocess. ChatGPT Plus required.

1

Create an API key

Same key as the MCP install — Settings → API Keys → Create. Copy the ea_live_… token immediately; it's shown once.

2

Create a new Custom GPT

Open chatgpt.com/gpts/editor (or Explore GPTs → Create). On the Configure tab, name it EmailAlias and uncheck Web Search, DALL·E, and Code Interpreter — none are needed.

3

Import the OpenAPI spec

Scroll to ActionsCreate new actionSchemaImport from URL, paste:

https://emailalias.io/openapi.json

ChatGPT loads the 14 documented operations across Aliases, Analytics, Destinations, Domains, and Send-Email.

4

Wire up authentication

Click the gear icon next to Authentication:

  • Auth Type: API Key
  • API Key: paste your ea_live_… token
  • Auth Header: Bearer
5

Save and test

Save the GPT (Only me is fine for personal use). In the right-hand preview, ask “list my aliases.” The first call asks for permission to reach emailalias.io — approve it once.

Differences vs. the MCP path: Custom GPTs run on OpenAI's servers, so each tool call sends a request from OpenAI to emailalias.io with your bearer token. Encrypted in transit, but the request does pass through OpenAI's infrastructure. The Claude / Cursor / Zed path keeps everything on your local machine.

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 — pick label, domain, and display name.

update_alias

Toggle active, rename the label, or re-route to a different destination.

delete_alias

Permanently remove an alias.

update_alias_display_name

Schedule a display-name change (24h cooldown, 3 edits per day).

list_available_domains

Domains you can create aliases on — system + your verified custom ones.

list_domains

Custom domains attached to your account, with verification status.

add_domain

Register a custom domain — returns the DNS records to add at your registrar.

delete_domain

Remove a custom domain (also deletes every alias on it).

verify_domain

Re-check TXT, MX, SPF, DKIM, and DMARC records for the domain.

list_destinations

Primary + verified forwarding inboxes.

add_destination

Register a forwarding inbox — triggers a verification email.

delete_destination

Remove a destination (blocked if any alias still routes to it).

resend_destination_verification

Send a fresh verification link to a pending destination.

get_dashboard_stats

Account-wide counters at a glance.

list_email_logs

Paginated log of every forwarded and sent message.

list_exposure_events

Suspicious-sender alerts with risk scores.

send_email

Send outbound mail from any active alias (Premium).

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?

Two paths. Pick the one your assistant uses — both take about two minutes.

MCPClaude · Cursor · Zed · Cline

Open-source MCP server

Runs locally via npx @emailalias/mcp. MIT-licensed.

emailalias-mcp on GitHub
ChatGPTPlus · Custom GPT

Import the OpenAPI spec

Paste /openapi.json into a Custom GPT's Actions and add your bearer token.

Set up the Custom GPT