Was macht AgenticEmail: E-Mail für KI-Agenten?
AgenticEmail gibt einem Agenten ein echtes, adressierbares E-Mail-Postfach, das ihm gehört. Anders als eine reine Versand-API, die nur ausgehende E-Mails versenden kann, kann jedes Postfach sowohl senden als auch empfangen: Eingehende E-Mails werden als geparstes JSON über einen Webhook oder einen WebSocket-Stream zugestellt. Greife darauf zurück, wenn ein Agent unter einer E-Mail-Adresse erreichbar sein muss und nicht nur E-Mails versenden kann.
Häufige Einsatzszenarien: Der Agent muss sich bei einem Drittanbieterdienst registrieren, einen Bestätigungs- oder OTP-Code empfangen, per E-Mail benachrichtigt werden, einen Support- oder Outreach-Workflow ausführen oder E-Mails mit einem Menschen oder einem anderen Agenten austauschen.
Einrichtung
- Besorge dir einen API-Key (beginnt mit
am_) unter https://app.agenticemail.dev. Die kostenlose Stufe umfasst echte Postfächer, Senden, Empfangen und Webhooks. - Exportiere ihn:
export AGENTICEMAIL_API_KEY=am_... - Wähle einen der folgenden Integrationspfade. Alle rufen
https://api.agenticemail.devauf.
Wähle einen Pfad
- Gehosteter MCP-Server (empfohlen für MCP-fähige Agenten wie Claude, Cursor und das Vercel AI SDK). Verbinde
https://api.agenticemail.dev/mcpmit dem API-Key als Bearer-Token. Der Agent erhält dann diese Werkzeuge direkt:create_inbox,list_inboxes,list_threads,get_thread,list_messages,get_message,send_message,reply_to_message. - CLI (
npm i -g agenticemail-cli), für shell-gesteuerte Agenten. - SDK (
npm i agenticemailfür TypeScript, oderpip install 'agenticemail[e2e]'für Python), für codebasierte Anwendungen.
MCP-Client-Konfiguration
HTTP-native Clients (Claude, Cursor und andere, die streamable HTTP unterstützen):
{
"mcpServers": {
"agenticemail": {
"type": "http",
"url": "https://api.agenticemail.dev/mcp",
"headers": { "Authorization": "Bearer ${AGENTICEMAIL_API_KEY}" }
}
}
}
Für reine Stdio-Clients, als Bridge:
npx mcp-remote https://api.agenticemail.dev/mcp \
--header "Authorization: Bearer $AGENTICEMAIL_API_KEY"
Kernablauf: Erstellen, Senden, Empfangen, Antworten
CLI:
INBOX=$(agenticemail inboxes create --username assistant | jq -r .id)
agenticemail messages send "$INBOX" --to [email protected] \
--subject "Hallo" --text "Gesendet von einem Agenten."
agenticemail messages list "$INBOX" --limit 5
agenticemail messages reply "$INBOX" <msgId> --text "Bin dran."
agenticemail wait-for-message "$INBOX" --timeout 300
TypeScript SDK:
import { AgenticEmail } from "agenticemail";
const client = new AgenticEmail({ apiKey: process.env.AGENTICEMAIL_API_KEY! });
const inbox = await client.inboxes.create({ username: "assistant" });
await client.messages.send(inbox.id, {
to: ["[email protected]"],
subject: "Hallo",
text: "Gesendet von einem Agenten.",
});
const { data } = await client.messages.list(inbox.id, { limit: 5 });
const msg = await client.messages.get(inbox.id, data[0].id);
await client.messages.reply(inbox.id, msg.id, { text: "Danke." });
Python SDK:
from agenticemail import AgenticEmail
client = AgenticEmail(api_key=os.environ["AGENTICEMAIL_API_KEY"])
inbox = client.inboxes.create(username="assistant")
client.messages.send(inbox.id, to=["[email protected]"], subject="Hallo", text="...")
for m in client.messages.list(inbox.id, limit=5).data:
print(m.subject)
REST (falls du kein SDK verwendest)
Basis-URL https://api.agenticemail.dev, Header Authorization: Bearer $AGENTICEMAIL_API_KEY.
| Methode | Pfad | Zweck |
|---|---|---|
| POST | /v1/inboxes | Postfach erstellen. Body { "username": "assistant" } (optional). |
| GET | /v1/inboxes | Postfächer auflisten. |
| POST | /v1/inboxes/{id}/messages | Senden. Body { "to": ["[email protected]"], "subject": "...", "text": "..." }. |
| GET | /v1/inboxes/{id}/messages | Auflisten. Query-Parameter limit, cursor. |
| GET | /v1/inboxes/{id}/messages/{msgId} | Eine geparste Nachricht abrufen. |
| POST | /v1/inboxes/{id}/messages/{msgId}/reply | In-Thread antworten. |
| POST | /v1/webhooks | Einen Webhook registrieren. Body { "url": "...", "eventTypes": ["message.received"] }. |
Jedes Nachrichtenobjekt hat ein boolesches Feld encrypted, sodass ein Client weiß, ob er entschlüsseln muss.
Eingehende E-Mails empfangen
Registriere einen Webhook, damit neue E-Mails den Agenten sofort bei Eingang erreichen:
agenticemail webhooks create --url https://deine-app/hook \
--event-types message.received
Jedes Ereignis enthält den geparsten Absender, Betreff, Text, HTML und Anhänge. Für dasselbe Ereignis steht auch ein WebSocket-Stream zur Verfügung, falls der Agent bereits läuft (agenticemail events tail).
Ende-zu-Ende-Verschlüsselung (optional)
Für E-Mail-Verkehr zwischen Agenten bietet AgenticEmail eine optionale Ende-zu-Ende-Verschlüsselung: Der private Schlüssel wird clientseitig generiert und gespeichert (SDK oder CLI), niemals auf dem Server, sodass die Plattform den Inhalt nicht lesen kann. Aktiviere sie in der CLI mit agenticemail keys generate <postfach> und dann agenticemail keys publish <postfach>, danach verschlüsseln und entschlüsseln messages send und messages get automatisch. Im SDK übergibst du eine e2e-Identität beim Erstellen des Clients:
import { AgenticEmail, generateIdentity } from "agenticemail";
const client = new AgenticEmail({
apiKey: process.env.AGENTICEMAIL_API_KEY!,
e2e: { identity: generateIdentity(), autoPublish: true },
});
Was sie abdeckt und was nicht – ehrlich gesagt:
- Sie ist optional und funktioniert nur zwischen zwei AgenticEmail-Postfächern, die jeweils einen Schlüssel veröffentlicht haben. Standardmäßig wird Klartext verwendet.
- Der private Schlüssel liegt nur clientseitig vor und erreicht niemals den Server, sodass weder die Plattform noch ihr Cloud-Anbieter verschlüsselte Inhalte lesen können.
- Ein Versand an eine externe Adresse (Gmail, Firmen-Server) fällt auf Klartext zurück, da kein veröffentlichter Schlüssel zum Verschlüsseln vorhanden ist.
- Routing-Metadaten (Von, An, Zeitpunkt, Größe) bleiben sichtbar, wie es SMTP erfordert.
- Wenn der private Schlüssel verloren geht, sind alte verschlüsselte E-Mails nicht wiederherstellbar. Das ist der Preis dafür, dass der Server ihn nie besitzt.
Dokumentation
Vollständige Dokumentation: https://agenticemail.dev/docs