AgenticEmail: E-Mail für KI-Agenten

Gib einem KI-Agenten ein eigenes, echtes E-Mail-Postfach mit Senden, Empfangen, Antworten, MCP-Unterstützung und optionaler Ende-zu-Ende-Verschlüsselung.

Was ist AgenticEmail: E-Mail für KI-Agenten?

AgenticEmail stattet KI-Agenten (wie Claude, Cursor, Codex oder benutzerdefinierte SDK-basierte Agenten) mit einem vollwertigen, adressierbaren E-Mail-Postfach aus. Anders als reine Versand-APIs kann der Agent damit sowohl E-Mails senden als auch empfangen, eingehende Nachrichten über Webhooks oder WebSocket-Streams verarbeiten und auf E-Mail-Threads antworten. Das Skill eignet sich ideal für Anwendungsfälle wie die Registrierung bei Drittanbieterdiensten (Verifizierungs-/OTP-Codes), automatisierte Support- oder Outreach-Workflows, Benachrichtigungen und E-Mail-Austausch zwischen Agenten oder mit Menschen. Die Einrichtung erfolgt über einen API-Key, eine MCP-Server-Konfiguration (empfohlen für Claude, Cursor, Vercel AI SDK) oder direkt per CLI/SDK. Optional kann eine clientseitige Ende-zu-Ende-Verschlüsselung aktiviert werden, bei der der private Schlüssel nie den Server erreicht, sodass die Plattform den Inhalt nicht lesen kann. Das Skill unterstützt vollständige E-Mail-Operationen (Erstellen von Postfächern, Senden, Auflisten, Abrufen, Beantworten) und eingehende Nachrichten über Webhooks oder WebSockets.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor✓Antigravity
npx skills add AgenticEmail/agenticemail-skill

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  1. Besorge dir einen API-Key (beginnt mit am_) unter https://app.agenticemail.dev. Die kostenlose Stufe umfasst echte Postfächer, Senden, Empfangen und Webhooks.
  2. Exportiere ihn: export AGENTICEMAIL_API_KEY=am_...
  3. Wähle einen der folgenden Integrationspfade. Alle rufen https://api.agenticemail.dev auf.

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/mcp mit 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 agenticemail für TypeScript, oder pip 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.

MethodePfadZweck
POST/v1/inboxesPostfach erstellen. Body { "username": "assistant" } (optional).
GET/v1/inboxesPostfächer auflisten.
POST/v1/inboxes/{id}/messagesSenden. Body { "to": ["[email protected]"], "subject": "...", "text": "..." }.
GET/v1/inboxes/{id}/messagesAuflisten. Query-Parameter limit, cursor.
GET/v1/inboxes/{id}/messages/{msgId}Eine geparste Nachricht abrufen.
POST/v1/inboxes/{id}/messages/{msgId}/replyIn-Thread antworten.
POST/v1/webhooksEinen 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

Verwandte Skills