Postmark MCP Server

Der Postmark MCP Server verbindet KI-Assistenten wie Claude Code oder Cursor mit Ihrem Postmark-Konto. Statt in der Weboberfläche nach einer Nachricht zu suchen oder API-Aufrufe von Hand zu schreiben, formulieren Sie eine Aufgabe, etwa „Warum hat diese Adresse meine Bestätigungsmail nicht erhalten?“ oder „Lege eine Vorlage für die Willkommensmail an“, und der Assistent ruft die passenden Werkzeuge auf. Das Projekt trägt laut Repository den Zusatz „Official Postmark MCP server by ActiveCampaign“, steht unter der MIT-Lizenz, hat aktuell rund 60 Sterne, ist nicht archiviert und wurde zuletzt am 14. Oktober 2026 aktualisiert. Das Paket heißt @activecampaign/postmark-mcp; achten Sie auf genau diesen Namen und die Repository-Adresse der Organisation ActiveCampaign, denn in der Vergangenheit sind nachgemachte Pakete mit ähnlichem Namen aufgefallen.

Was kann der Postmark MCP Server?

Laut README stellt der Server 24 Werkzeuge in mehreren Gruppen bereit. Beim Versand gibt es das Senden einer einzelnen E-Mail (an einen oder bis zu 50 Empfänger), das Senden mit einer Vorlage sowie Stapelversand mit bis zu 500 voneinander unabhängigen Nachrichten pro Aufruf. Für Vorlagen stehen Auflisten, Lesen, Anlegen, Bearbeiten, Löschen und Prüfen zur Verfügung. Hinzu kommen die Suche in versendeten Nachrichten samt Detailansicht, Bounces (Zustellfehler) suchen, abrufen und reaktivieren, Sperrlisten (Suppressions) verwalten, Zustellstatistiken, Serverinformationen und Webhooks. Besonders praktisch ist ein Diagnosewerkzeug: Es prüft für eine Empfängeradresse Nachrichten, Sperrlisten und Bounces und empfiehlt eine Maßnahme.

Wofür ist er besonders nützlich?

Der Nutzen liegt vor allem in der Fehlersuche und Pflege. Wenn ein Kunde meldet, die Passwort-Mail sei nie angekommen, kann der Assistent die Nachricht suchen, den Status lesen und erklären, ob eine Sperrliste oder ein Bounce dahintersteckt. Beim Gestalten von Vorlagen prüft er Inhalte, bevor sie live gehen. Gegenüber dem manuellen Durchklicken spart das Zeit, weil der Assistent mehrere Abfragen verkettet und die Antwort in Prosa liefert. Wer ohnehin mit Claude Code oder Cursor an einer Anwendung arbeitet, kann so E-Mail-Themen im selben Gespräch erledigen.

Einrichtung und Konfiguration

Voraussetzung ist Node.js ab Version 20 sowie ein Postmark-Konto mit Server-Token. Empfohlen wird der Start ohne Klon per npx -y @activecampaign/postmark-mcp. Drei Umgebungsvariablen sind Pflicht: POSTMARK_SERVER_TOKEN für das Token, DEFAULT_SENDER_EMAIL für eine in Postmark bestätigte Absenderadresse und DEFAULT_MESSAGE_STREAM, zum Beispiel outbound. Optional gibt es AGENT_LABEL zur Kennzeichnung des Datenverkehrs, WEBHOOK_URL_ALLOWLIST zur Begrenzung erlaubter Webhook-Adressen, LOG_FILE und LOG_EMAIL_FULL. Für Cursor bietet das Repository eine Schnellinstallation, für Claude Desktop tragen Sie den Server in der Konfigurationsdatei ein.

Sicherheit: was Sie beachten sollten

Der Server besitzt laut README die vollen Rechte des verwendeten Server-Tokens; Postmark kennt dafür keine eingeschränkten Berechtigungen. Das Repository empfiehlt deshalb einen eigenen Postmark-Server nur für MCP-Verkehr mit begrenzten Streams und Absendern sowie das Rotieren des Tokens bei Verdacht auf Offenlegung. Die Werkzeuge sind in Risikostufen eingeteilt: lesend (zwölf Werkzeuge), hinzufügend, versendend und zerstörend (Vorlage bearbeiten oder löschen, Webhook oder Sperrliste löschen). Lassen Sie Bestätigungsabfragen für Senden und Ändern eingeschaltet. Außerdem warnt die README vor Prompt Injection: Schädliche Inhalte in E-Mails oder Vorlagen könnten den Assistenten zu unbeabsichtigten Aufrufen verleiten. Beim Anlegen von Webhooks sind nur HTTPS-Adressen erlaubt, und eine Erlaubnisliste empfiehlt sich.

Grenzen

Die README nennt einige Einschränkungen: Das Auflisten von Vorlagen liefert die ersten 100 ohne Seitenwechsel, Sperrlisten-Aufrufe verarbeiten bis zu 50 Adressen, Spam-Beschwerden lassen sich nicht aus der Sperrliste löschen, Bounce-Dumps bleiben 30 Tage verfügbar, und der Server nutzt nur die synchrone Stapelschnittstelle, nicht die asynchrone Bulk-API. Open- und Click-Tracking wird bei jedem Versand automatisch aktiviert, was Sie bei datenschutzsensiblen Mails bedenken sollten.

Kosten

Der MCP-Server selbst ist unter MIT-Lizenz kostenlos. Kosten entstehen für Postmark. Laut Preisseite gibt es einen dauerhaft kostenlosen Entwicklerplan mit einem kleinen monatlichen Kontingent und ohne Überschreitung, dazu kostenpflichtige Pläne mit größeren Kontingenten, mehr Absenderdomänen und längerer Datenaufbewahrung; zusätzliche Nachrichten werden je tausend abgerechnet. Aktuelle Konditionen stehen auf der offiziellen Preisseite.

Für wen lohnt sich der Postmark MCP Server?

Er lohnt sich für Teams und Einzelentwickler, die Postmark bereits für Anwendungs-E-Mails nutzen und Diagnose, Vorlagenpflege und Statistik im Gespräch erledigen möchten. Ohne Postmark-Konto bringt er nichts. Beginnen Sie mit einem Testserver und lesenden Aufgaben, bevor Sie Versand oder Änderungen freigeben.

Node.js ab Version 20, ein MCP-Client wie Claude Code oder Cursor sowie ein Postmark-Konto mit Server-Token und einer bestätigten Absenderadresse.

Mit dem Postmark MCP Server sucht ein KI-Assistent Nachrichten, pflegt Vorlagen und diagnostiziert Zustellprobleme. Dieser Ratgeber führt von den Voraussetzungen bis zur ersten Abfrage.

Schritt 1: Voraussetzungen prüfen

Sie benötigen Node.js ab Version 20, einen MCP-Client wie Claude Code oder Cursor und ein Postmark-Konto. Legen Sie in Postmark einen eigenen Server nur für den MCP-Einsatz an, denn das Token besitzt alle Rechte dieses Servers und lässt sich nicht einschränken.

Schritt 2: Token und Absender vorbereiten

Kopieren Sie das Server-Token aus Postmark. Außerdem brauchen Sie eine dort bestätigte Absenderadresse und den Namen des Nachrichtenstroms, in der Regel outbound. Für Tests nutzen Sie einen Testserver, damit keine echten Kunden Mails erhalten.

Schritt 3: Im MCP-Client eintragen

In Claude Code lautet der Befehl claude mcp add postmark -e POSTMARK_SERVER_TOKEN=<token> -e DEFAULT_SENDER_EMAIL=<absender> -e DEFAULT_MESSAGE_STREAM=outbound -- npx -y @activecampaign/postmark-mcp. In Cursor nutzen Sie die Schnellinstallation aus dem Repository oder ergänzen die .cursor/mcp.json mit denselben Angaben. Verwenden Sie genau den Paketnamen @activecampaign/postmark-mcp, nicht ähnlich klingende Pakete.

claude mcp add postmark -e POSTMARK_SERVER_TOKEN=<token> -e DEFAULT_SENDER_EMAIL=<absender> -e DEFAULT_MESSAGE_STREAM=outbound -- npx -y @activecampaign/postmark-mcp

Risiken begrenzen

Lassen Sie Bestätigungsabfragen für Senden und Ändern eingeschaltet; nur lesende Werkzeuge dürfen automatisch laufen. Mit WEBHOOK_URL_ALLOWLIST begrenzen Sie die Adressen, die createWebhook akzeptiert. Behandeln Sie Inhalte eingehender E-Mails als nicht vertrauenswürdig, denn sie könnten den Assistenten manipulieren.

Schritt 4: Erste Abfragen

Beginnen Sie mit Leseaufgaben, etwa „Zeige die Zustellstatistik der letzten Woche“ oder „Suche die letzten Nachrichten an kunde@example.com“. Bleibt eine Mail aus, bitten Sie den Assistenten um eine Diagnose der Adresse. Versand und Änderungen testen Sie zuerst auf dem Testserver.

Postmark-Server-Token als Umgebungsvariable POSTMARK_SERVER_TOKEN.

Lesender und schreibender Zugriff auf den Postmark-Server des Tokens: E-Mails senden, Vorlagen, Sperrlisten und Webhooks ändern, Nachrichten und Bounces lesen. Das Token ist nicht einschränkbar.

Der Server läuft lokal bei Ihnen und spricht mit der Postmark-API. Abgerufene Nachrichten, Adressen und Vorlagen gelangen in den Kontext des KI-Clients und damit zum Modellanbieter. Protokolle maskieren E-Mail-Adressen standardmäßig teilweise.

Unbeabsichtigter Versand echter E-Mails, Löschen von Vorlagen, Webhooks oder Sperrlisteneinträgen, Prompt Injection über E-Mail-Inhalte, ein nicht einschränkbares Token sowie nachgemachte Pakete mit ähnlichem Namen.