@emailalias/mcp

MCP-Server für die EmailAlias.io REST-API. Ermöglicht das Erstellen, Verwalten und Überwachen von E-Mail-Aliassen aus Claude Desktop, Cursor, Zed, Cline und jedem anderen MCP-kompatiblen KI-Assistenten — in natürlicher Sprache.

„Erstelle einen neuen Alias für Substack, nenne ihn 'Newsletter'“ „Deaktiviere den Amazon-Alias, ich erhalte Spam“ „Zeige mir die Aliase, die diese Woche als verdächtige Absender markiert wurden“

Der API-Zugriff ist ein Premium-Feature. Generieren Sie einen API-Schlüssel unter Einstellungen → API-Schlüssel im Dashboard.

Installation

Claude Desktop

Bearbeiten Sie Ihre Konfigurationsdatei:

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

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Fügen Sie den Eintrag emailalias unter mcpServers hinzu:

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

Starten Sie Claude Desktop neu. Sie sollten ein 🔌-Steckersymbol sehen, das bestätigt, dass der Server verbunden ist.

Cursor, Zed, Cline und andere MCP-Clients

Jeder MCP-kompatible Client akzeptiert das gleiche Format. Konsultieren Sie die Dokumentation Ihres Clients für den genauen Konfigurationspfad und verwenden Sie dann:

command: npx
args: -y @emailalias/mcp
env: EMAILALIAS_API_KEY=ea_live_...

Globale Installation (optional)

Wenn Sie nicht möchten, dass npx das Paket bei jedem Start herunterlädt:

npm install -g @emailalias/mcp

Ändern Sie dann command zu emailalias-mcp und entfernen Sie die Argumente -y @emailalias/mcp.

Related MCP server: Inbound Email MCP Server

Konfiguration

Verfügbare Tools

Beispiel-Prompts (Claude Desktop)

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

Show me all aliases that have received zero emails in 30 days.

Disable every alias labelled "shopping" and list what you disabled.

What's my exposure alert count for this month?

Entwicklung

git clone https://github.com/emailalias/emailalias-mcp.git
cd emailalias-mcp
npm install
npm run build

# Test against the MCP Inspector (installs on demand)
npx @modelcontextprotocol/inspector node dist/index.js

EMAILALIAS_API_KEY muss für manuelle Ausführungen in Ihrer Shell gesetzt sein.

Sicherheitshinweise

• Ihr API-Schlüssel bleibt auf Ihrem Rechner. Dieser Server läuft lokal (stdio-Transport), ruft die EmailAlias-API über HTTPS auf und sendet den Schlüssel direkt. Kein Dritter sieht ihn.

• Committen Sie nicht claude_desktop_config.json — sie enthält Ihren Schlüssel. Behandeln Sie sie wie eine .env-Datei.

• Der Umfang ist wichtig. Jedes MCP-Tool, das Ihre KI entscheidet aufzurufen, wird gegen Ihr Live-Konto ausgeführt. Überprüfen Sie, was das Modell vorschlägt, bevor Sie destruktive Aktionen wie delete_alias genehmigen.

Links

• API-Dokumentation: https://emailalias.io/documentation

• EmailAlias.io: https://emailalias.io

• Model Context Protocol: https://modelcontextprotocol.io

Lizenz

MIT