DearAgent: MCP-Server, der KI-Agenten ein selbst gehostetes Postfach gibt

DearAgent ist eine selbst gehostete E-Mail-API für KI-Agenten, die auf Cloudflare Workers läuft – E-Mails werden in D1 gespeichert, Anhänge in R2. Es positioniert sich als Open-Source-Alternative zu AgentMail und stellt über den /mcp-Endpunkt des Workers einen zustandslosen Streamable-HTTP-MCP-Server bereit.

Für wen ist es geeignet?

• Für Entwickler, die ihren KI-Agenten echte Empfangsfähigkeiten geben möchten: Der typische Ablauf ist, ein Postfach zu erstellen, auf die Verifizierungs-E-Mail zu warten und den Verifizierungslink auszulesen.
• Klare Voraussetzungen: ein Cloudflare-Konto, eine dedizierte Top-Level-Domain für Cloudflare Email Routing sowie Node 20+ und der Befehl npx wrangler login. Der Empfang von E-Mails ist kostenlos; nur für den Versand wird Workers Paid benötigt.
• API und MCP nutzen denselben API_KEY als einzigen Bearer-Token – ein Schlüssel mit vollem Zugriff (Single-Tenant), ungeeignet für Multi-User-Szenarien, die eine feingranulare Rechte-Trennung erfordern.
• Nicht geeignet, wenn man keine eigene Domain besitzt, selbst gehostete Bereitstellung und Wartung nicht übernehmen will oder Multi-Tenant-Rechte-Trennung braucht. Aspekte, die die offiziellen Quellen nicht erwähnen (z. B. Datenaufbewahrung oder Löschrichtlinien), sind unbekannt – bitte selbst verifizieren.

Erster Versuch in 3 Minuten

Der offiziell empfohlene Hauptweg ist das Klonen des Repositories und das Ausführen des interaktiven Setup-Skripts, das D1, R2, Schlüssel und Email Routing/Sending automatisch konfiguriert, die Bereitstellung abschließt und eine Catch-all-Regel anlegt:

git clone https://github.com/panda-sandeep/dearagent && cd dearagent
npm install
npm run setup

Voraussetzung: Du bist bereits per npx wrangler login bei Cloudflare angemeldet, und die Domain ist für Email Routing nutzbar. Das Skript führt durch die Einrichtung des erforderlichen API_KEY (alternativ per npx wrangler secret put API_KEY), der als einziger Bearer-Token für API und MCP dient.

Für den ersten Aufruf empfiehlt sich das risikoarme Lese-Tool list_inboxes: Richte in deinem MCP-Client den /mcp-Endpunkt des Workers inklusive Bearer-Schlüssel ein und rufe list_inboxes auf. Wird die Postfachliste zurückgegeben, funktionieren Bereitstellung und Authentifizierung. Beachte: Dies ist ein selbst gehosteter Dienst, kein Remote-Hosting durch Dritte; create_inbox schreibt in deine eigene D1-Datenbank.

Wenn du nur E-Mails empfangen willst, benötigst du kein Workers Paid; erst wenn du send_message zum Versand nutzen möchtest, stelle sicher, dass Workers Paid aktiviert ist – der Versand erzeugt echte ausgehende E-Mails (auf MCP-Ebene nicht widerrufbar; beurteile dies nach dem tatsächlichen Verhalten von Email Sending).

Anwendungsfälle

Fall 1: Registrierungsverifizierung durch den Agenten automatisieren. Erstelle mit create_inbox ein Postfach, trage die Adresse in das Registrierungsformular der Ziel-Website ein, warte mit wait_for_message auf die Verifizierungs-E-Mail und lies den Verifizierungslink aus dem Inhalt. Dies ist der offiziell beschriebene typische Ablauf; die Tools geben die echten E-Mail-Inhalte aus deinem selbst gehosteten Dienst zurück.

Fall 2: Historische E-Mails abrufen. Suche mit search_messages nach Schlüsselwörtern, oder nutze list_threads / get_thread für Unterhaltungen, get_message für einzelne E-Mails und get_attachment für Anhänge. Dies sind reine Leseoperationen auf bestehende Daten in deinem D1/R2 – ideal, um E-Mails nachzuvollziehen, die der Agent zuvor erhalten hat.

Die übrigen Tools (z. B. send_message, reply_to_message, forward_message, list_webhooks, create_webhook) werden in den Quellen als verfügbar aufgeführt, aber deren Parameterdetails sind dort nicht dokumentiert – halte dich vor der Nutzung an das README des Repositories.

Nutzungsgrenzen

• Lese-/Schreibverhalten: list_*, get_*, search_messages und wait_for_message sind Abfrageoperationen; create_inbox, create_webhook, send_message, reply_to_message und forward_message schreiben Daten oder lösen echte ausgehende Aktionen aus – vor dem Aufruf prüfen.
• Zugangsdaten und Daten: Ein einzelner API_KEY gewährt vollen Zugriff – sicher verwahren; alle E-Mail-Daten liegen in deinem eigenen Cloudflare D1/R2.
• Nebenwirkungen: Der E-Mail-Versand erfordert Workers Paid und erfolgt real; es gibt kein offiziell dokumentiertes Verfahren zum Zurückziehen gesendeter E-Mails – nicht als widerrufbar betrachten.
• Unbekanntes: Aufbewahrungsfristen, Lösch-Tools und Details zum Datenschutz werden in den offiziellen Quellen nicht genannt; diese Punkte sind unbestätigt und rechtfertigen keine Annahme von Risikofreiheit.