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.
Create an alias for signing up to Substack, label it "newsletter".
Done. x7k9m@email91.com is live and forwarding to your primary inbox.
create_aliasDisable the amazon alias, I'm getting too much spam on it.
Disabled. Incoming mail to that alias will silently bounce until you re-enable it.
update_aliasShow me aliases that got zero emails in the last 30 days.
Found 4: shopping-target, retro-forum, devmeetup-2024, conf-rsvp.
list_aliaseslist_email_logsWhich aliases were flagged for suspicious senders this week?
2 alerts — gaming-trial (.xyz typo-domain) and travel-deals (phishing pattern).
list_exposure_eventsSend a reply from my work-signup alias thanking them for the demo.
Sent. The recipient sees the reply coming from your alias, not your real address.
send_emailInstall
Claude · Cursor · Zed · ClineThe 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.”
Using ChatGPT?
Custom GPT · OpenAI ActionsChatGPT 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.
Create an API key
Same key as the MCP install — Settings → API Keys → Create. Copy the ea_live_… token immediately; it's shown once.
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.
Import the OpenAPI spec
Scroll to Actions → Create new action → Schema → Import from URL, paste:
https://emailalias.io/openapi.jsonChatGPT loads the 14 documented operations across Aliases, Analytics, Destinations, Domains, and Send-Email.
Wire up authentication
Click the gear icon next to Authentication:
- Auth Type:
API Key - API Key: paste your
ea_live_…token - Auth Header:
Bearer
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.
Available tools
The LLM decides which of these to call based on your request. Descriptions here mirror what the model sees.
list_aliasesEvery alias with forwarded / blocked counts.
create_aliasRandom, custom, or tagged alias — pick label, domain, and display name.
update_aliasToggle active, rename the label, or re-route to a different destination.
delete_aliasPermanently remove an alias.
update_alias_display_nameSchedule a display-name change (24h cooldown, 3 edits per day).
list_available_domainsDomains you can create aliases on — system + your verified custom ones.
list_domainsCustom domains attached to your account, with verification status.
add_domainRegister a custom domain — returns the DNS records to add at your registrar.
delete_domainRemove a custom domain (also deletes every alias on it).
verify_domainRe-check TXT, MX, SPF, DKIM, and DMARC records for the domain.
list_destinationsPrimary + verified forwarding inboxes.
add_destinationRegister a forwarding inbox — triggers a verification email.
delete_destinationRemove a destination (blocked if any alias still routes to it).
resend_destination_verificationSend a fresh verification link to a pending destination.
get_dashboard_statsAccount-wide counters at a glance.
list_email_logsPaginated log of every forwarded and sent message.
list_exposure_eventsSuspicious-sender alerts with risk scores.
send_emailSend 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.
Open-source MCP server
Runs locally via npx @emailalias/mcp. MIT-licensed.
Import the OpenAPI spec
Paste /openapi.json into a Custom GPT's Actions and add your bearer token.