Resend MCP-Server

Ein MCP-Server für die Resend-Plattform. Senden und empfangen Sie E-Mails, verwalten Sie Kontakte, Broadcasts, Domains und mehr – direkt aus jedem MCP-Client wie Claude Desktop, Cursor oder Claude Code.

Funktionen

• E-Mails — Senden, auflisten, abrufen, stornieren, aktualisieren und E-Mails im Batch versenden. Unterstützt HTML, Klartext, Anhänge (lokale Datei, URL oder Base64), CC/BCC, Reply-To, Zeitplanung, Tags und themenbasierten Versand.

• Empfangene E-Mails — Eingehende E-Mails auflisten und lesen. Anhänge empfangener E-Mails auflisten und herunterladen.

• Kontakte — Kontakte erstellen, auflisten, abrufen, aktualisieren und entfernen. Verwalten Sie Segmentmitgliedschaften und Themenabonnements. Unterstützt benutzerdefinierte Kontakteigenschaften.

• Broadcasts — Broadcast-Kampagnen erstellen, versenden, auflisten, abrufen, aktualisieren und entfernen. Unterstützt Zeitplanung, Personalisierungs-Platzhalter und Vorschautext.

• Domains — Absender-Domains erstellen, auflisten, abrufen, aktualisieren, entfernen und verifizieren. Konfigurieren Sie Tracking, TLS sowie Sende- und Empfangsfähigkeiten.

• Segmente — Zielgruppensegmente erstellen, auflisten, abrufen und entfernen.

• Themen — Abonnement-Themen erstellen, auflisten, abrufen, aktualisieren und entfernen.

• Kontakteigenschaften — Benutzerdefinierte Kontaktattribute erstellen, auflisten, abrufen, aktualisieren und entfernen.

• API-Schlüssel — API-Schlüssel erstellen, auflisten und entfernen.

• Webhooks — Webhooks für Benachrichtigungen bei Ereignissen erstellen, auflisten, abrufen, aktualisieren und entfernen.

Related MCP server: blastengine-mailer

Einrichtung

Erstellen Sie ein kostenloses Resend-Konto und erstellen Sie einen API-Schlüssel. Um an Adressen außerhalb Ihrer eigenen zu senden, müssen Sie Ihre Domain verifizieren.

Verwendung

Der Server unterstützt zwei Transportmodi: stdio (Standard) und HTTP.

Stdio-Transport (Standard)

Claude Code

claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- npx -y resend-mcp

Cursor

Öffnen Sie die Befehlspalette und wählen Sie "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Öffnen Sie die Claude Desktop-Einstellungen > Tab "Developer" > "Edit Config".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

HTTP-Transport

Führen Sie den Server über HTTP für Remote- oder webbasierte Integrationen aus. Im HTTP-Modus authentifiziert sich jeder Client, indem er seinen Resend-API-Schlüssel als Bearer-Token im Authorization-Header übergibt.

Starten Sie den Server:

npx -y resend-mcp --http --port 3000

Der Server lauscht auf http://127.0.0.1:3000 und stellt den MCP-Endpunkt unter /mcp mittels Streamable HTTP bereit.

Claude Code

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor

Öffnen Sie die Befehlspalette und wählen Sie "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Sie können den Port auch über die Umgebungsvariable MCP_PORT festlegen:

MCP_PORT=3000 npx -y resend-mcp --http

Optionen

Sie können zusätzliche Argumente übergeben, um den Server zu konfigurieren:

• --key: Ihr Resend-API-Schlüssel (nur im stdio-Modus; der HTTP-Modus verwendet das Bearer-Token vom Client)

• --sender: Standard-Absender-E-Mail-Adresse von einer verifizierten Domain

• --reply-to: Standard-Reply-To-E-Mail-Adresse (kann mehrfach angegeben werden)

• --http: Verwenden Sie den HTTP-Transport anstelle von stdio (Standard: stdio)

• --port: HTTP-Port bei Verwendung von --http (Standard: 3000 oder MCP_PORT-Umgebungsvariable)

Umgebungsvariablen:

• RESEND_API_KEY: Ihr Resend-API-Schlüssel (erforderlich für stdio, optional für HTTP, da Clients ihn über das Bearer-Token übergeben)

• SENDER_EMAIL_ADDRESS: Standard-Absender-E-Mail-Adresse von einer verifizierten Domain (optional)

• REPLY_TO_EMAIL_ADDRESSES: Durch Kommas getrennte Reply-To-E-Mail-Adressen (optional)

• MCP_PORT: HTTP-Port bei Verwendung von --http (optional)

Lokale Entwicklung

1. Klonen Sie dieses Projekt und erstellen Sie den Build:

git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build

2. Um den lokalen Build zu verwenden, ersetzen Sie den npx-Befehl durch den Pfad zu Ihrem lokalen Build:

Claude Code (stdio):

claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- node ABSOLUTE_PATH_TO_PROJECT/dist/index.js

Claude Code (HTTP):

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor / Claude Desktop (stdio):

{
  "mcpServers": {
    "resend": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Cursor (HTTP):

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Live-Tests mit einem MCP-Client

Während der Entwicklung können Sie Änderungen in einer echten MCP-Client-Sitzung testen, während Sie den Code in einer anderen bearbeiten.

Die Idee: Führen Sie tsc --watch aus, um dist/ kontinuierlich neu zu erstellen, und verweisen Sie einen separaten MCP-Client aus einem anderen Verzeichnis auf die erstellte dist/index.js. Wenn Sie Codeänderungen übernehmen möchten, starten Sie die MCP-Client-Sitzung neu (MCP-Server sind langlebige stdio-Prozesse, die kein Hot-Reload unterstützen).

Beispiel mit Claude Code:

1. Führen Sie den TypeScript-Watcher aus, um beim Speichern automatisch neu zu erstellen:

   pnpm tsc --watch

2. Erstellen Sie in einem separaten Verzeichnis eine .mcp.json, die auf die Build-Ausgabe verweist:

   mkdir -p /tmp/mcp-test

   // /tmp/mcp-test/.mcp.json
   {
     "mcpServers": {
       "resend-dev": {
         "command": "node",
         "args": ["/absolute/path/to/resend-mcp/dist/index.js"],
         "env": {
           "RESEND_API_KEY": "re_xxxxxxxxx"
         }
       }
     }
   }

3. Starten Sie Claude Code aus diesem Verzeichnis und verwenden Sie die MCP-Tools. Starten Sie nach Codeänderungen eine neue Claude Code-Sitzung, um den neuen Build zu übernehmen.

Das gleiche Prinzip gilt für jeden MCP-Client – trennen Sie Ihre Testumgebung von Ihrer Entwicklungsumgebung, verwenden Sie einen absoluten Pfad zu dist/index.js und verbinden Sie den MCP-Server nach dem Neuerstellen erneut.

Testen mit dem MCP Inspector

Hinweis: Stellen Sie sicher, dass Sie das Projekt zuerst erstellt haben (siehe Abschnitt Lokale Entwicklung oben).

Verwendung des Stdio-Transports

1. Legen Sie Ihren API-Schlüssel fest:

   export RESEND_API_KEY=re_your_key_here

2. Starten Sie den Inspector:

   pnpm inspector

3. Im Browser (Inspector UI):

   • Wählen Sie stdio (einen Prozess starten).

   • Befehl: node

   • Argumente: dist/index.js (oder der vollständige Pfad zu dist/index.js)

   • Umgebung: RESEND_API_KEY=re_your_key_here (oder lassen Sie es leer, wenn Sie es bereits im selben Terminal exportiert haben).

   • Klicken Sie auf Connect und verwenden Sie dann "List tools", um zu überprüfen, ob der Server funktioniert.

Verwendung des HTTP-Transports

1. Starten Sie den HTTP-Server in einem Terminal:

   node dist/index.js --http --port 3000

2. Starten Sie den Inspector in einem anderen Terminal:

   pnpm inspector

3. Im Browser (Inspector UI):

   • Wählen Sie Streamable HTTP (mit URL verbinden).

   • URL: http://127.0.0.1:3000/mcp

   • Fügen Sie einen benutzerdefinierten Header hinzu: Authorization: Bearer re_your_key_here und aktivieren Sie den Schalter.

   • Klicken Sie auf Connect und verwenden Sie dann "List tools", um zu überprüfen, ob der Server funktioniert.