Zur Dokumentation springen
CLI

KI und MCP

Mail übersetzen, schreiben und zusammenfassen, KI-Clients mit Ihrem Postfach verbinden, MCP-Tools aufrufen und die Dokumentation befragen.

KI-Befehle

BefehlWas es tutAnmeldung
ai translateEinen Betreff und Body übersetzen, ohne etwas zu sendenBeide Arten, mit emails:send
ai languagesJede Sprache auflisten, die die Übersetzung annimmtBeliebig oder keine: abgemeldet gibt sie die in die CLI eingebaute Tabelle aus
ai compose "<prompt>"Einen E-Mail-Body in Ihrem eigenen Stil schreibenEine Browser-Anmeldung
ai summarize <thread-id>Die Zusammenfassung ausgeben, die OpenEmail für einen Thread führtEine Browser-Anmeldung

translate und compose verbrauchen je eine KI-Aktion aus dem Tageskontingent des Workspace, und ein aufgebrauchtes Kontingent bricht mit Exit-Code 8 ab. compose und summarize laufen über die MCP-Tools composeEmail und getThreadSummary, deshalb brauchen sie eine Browser-Anmeldung: Ein API-Schlüssel erreicht den MCP-Server nicht.

Übersetzen

Terminal
openemail ai translate --to de --subject "Your invoice" --text "The invoice is attached."openemail ai translate --to Japanese --body-file reply.html --no-originalcat notes.txt | openemail ai translate --to fropenemail ai languages --search port

Er führt die Übersetzung aus, die ein übersetzter Versand ausführen würde, und gibt das Ergebnis aus, sodass Sie es lesen können, bevor etwas rausgeht. Nichts wird gespeichert oder gesendet. --to nimmt einen Code, einen englischen Namen oder den Eigennamen der Sprache. Der Body kommt aus --text, --html, --body-file oder stdin, und --text und --html lesen auch eine Datei mit @path.

  • Ihr Originaltext bleibt unter der Übersetzung, außer Sie übergeben --no-original.
  • Die erkannte Ausgangssprache wird auf stderr ausgegeben, und --json gibt die ganze Übersetzung aus.
  • Um beim Senden zu übersetzen, nutzen Sie openemail send --translate de.

Schreiben und zusammenfassen

Terminal
openemail ai compose "thank Ada for the invoice and ask for a PDF copy" --to [email protected]openemail ai compose "say yes to Tuesday at 3pm" --thread CAHk7pQ2x9LmZ4 --tone friendlyopenemail ai compose "decline politely" --thread CAHk7pQ2x9LmZ4 | openemail send --to [email protected] --subject "Re: Proposal"openemail ai summarize CAHk7pQ2x9LmZ4
  • compose gibt einen in Ihrem Stil geschriebenen Body aus und sendet nichts, leiten Sie ihn also in openemail send weiter, wenn er Ihnen gefällt. Mit --thread liest es zuerst die neuesten Nachrichten des Threads und schreibt eine Antwort. --tone ist eines von formal, friendly, casual, concise, direct oder warm.
  • summarize gibt die Zusammenfassung mit Betreff, Absender und Datum aus. Zusammenfassungen entstehen, wenn Mail ankommt, und ein Thread mit einer verschlüsselten Nachricht hat keine, was mit Exit-Code 5 endet.

Einen KI-Client verbinden

Der MCP-Server von OpenEmail gibt einem KI-Client die Tools, die der Assistent in der App nutzt: Er kann Mail lesen und senden und Kontakte, Vorlagen, Domains und mehr verwalten, beschränkt auf das, was Sie freigeben. Ein Client verbindet sich auf eine von zwei Arten, und openemail mcp config gibt beide für Ihren Client aus:

  • Der Remote-Server. Der Client führt seine eigene Browser-Anmeldung aus, Sie geben ihn auf der Zustimmungsseite von OpenEmail frei, und er erscheint unter Konto → Verbundene Apps. Das ist die einfachere Wahl, wenn der Client es unterstützt.
  • Die lokale Brücke, openemail mcp serve, die der Client über npx startet. Sie nutzt die Anmeldung dieser CLI, führen Sie also zuerst openemail login aus. Sie passt zu Clients, die nur lokale Server starten.
Terminal
openemail mcp configopenemail mcp config --client claude-codeopenemail mcp config --client cursor --profile workopenemail mcp config --client vscode --json
claude mcp add --transport http openemail https://api.openemail.uk/mcp
claude mcp add openemail -- npx -y @openemail/cli mcp serve

Nach dem Hinzufügen des Remote-Servers meldet sich Claude Code über /mcp an und Codex mit codex mcp login openemail. Claude Desktop fügt ihn unter Settings → Connectors → Add custom connector hinzu. openemail mcp config --client <name> sagt außerdem, welche Datei jeder Client liest.

Die lokale Brücke

openemail mcp serve liest zeilenweise JSON-RPC auf stdin, leitet jede Nachricht mit Ihrer gespeicherten Browser-Anmeldung an den MCP-Server weiter und schreibt jede Antwort als eine Zeile auf stdout. Es erneuert ein abgelaufenes Zugriffstoken, ohne dass der Client es merkt, beantwortet einen Batch als ein Array und endet, wenn stdin schließt. Nur Protokoll erreicht stdout, und stderr bleibt still, außer Sie übergeben --debug.

Terminal
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | openemail mcp serveopenemail mcp serve --profile workopenemail mcp serve --debug 2> mcp.log

Die Brücke kann über stdio nicht nach einem Bestätigungscode fragen. Ein Tool, das einen braucht, erreicht den Client als Ablehnung, und die Brücke gibt einen Hinweis auf stderr aus. Führen Sie openemail verify in einem Terminal mit demselben Profil aus, und diese Tools laufen die nächsten 60 Minuten.

Tools selbst aufrufen

Terminal
openemail mcp toolsopenemail mcp tools composeEmailopenemail mcp call whoAmIopenemail mcp call listThreads --arg folder=inbox --arg maxResults=5openemail mcp call getThread --args '{"threadId":"CAHk7pQ2x9LmZ4"}'
  • mcp tools listet die Tools, die diese Anmeldung nutzen darf, ohne die, die Ihre Rolle oder die Freigabe nicht erlaubt. Nennen Sie ein Tool, um seine Beschreibung und Argumente zu sehen.
  • mcp call nimmt die Argumente als ein JSON-Objekt in --args (inline, @file oder -), und --arg key=value setzt eines nach dem anderen. Ein Wert wird als JSON gelesen, wenn er sich parsen lässt, setzen Sie eine Zahl, die Sie als Text meinen, also in Anführungszeichen.
  • Der MCP-Server fragt nie nach einer Bestätigung, ein Tool, das sendet oder löscht, handelt also sofort.
  • Ein Ergebnis, das mit Refused ( beginnt, endet mit Exit-Code 4. Ein unbekanntes Tool endet mit 5, ungültige Argumente mit 7 und ein aufgebrauchtes KI-Kontingent mit 8.

Sechs Tools nehmen eine Änderung vor, die die REST API mit einem Bestätigungscode schützt, und fragen nach demselben Code: createRule, setRuleEnabled, removeDomain, removeDomainAddress, deleteAudience für eine Zielgruppe, die Sie angelegt haben, und emptyAudience für eine selbst angelegte Zielgruppe, die noch Kontakte enthält. In einem Terminal fragt mcp call nach dem Code und ruft das Tool erneut auf. Unbeaufsichtigt endet es mit Exit-Code 4, führen Sie also zuerst openemail verify aus.

Die Dokumentation befragen

Terminal
openemail docs ask "how do I verify a domain?"openemail docs open cli/authenticationopenemail docs read cli/commandsopenemail docs read
  • docs ask stellt dem Docs-Assistenten eine Frage und gibt die Antwort aus, während sie entsteht, dann die Seiten, aus denen sie stammt. Er antwortet nur aus dieser Dokumentation, braucht keine Anmeldung und sendet nie Ihre Anmeldeinformationen. Eine Frage darf bis zu 600 Zeichen lang sein, und jedes Netzwerk kann eine begrenzte Zahl pro Tag stellen.
  • docs open öffnet eine Seite in Ihrem Browser, und --print gibt stattdessen ihren Link aus.
  • docs read gibt eine Seite als Markdown aus. Ohne Seite gibt es das Verzeichnis aller Seiten aus.

Der Posteingang,
nach eigenen Regeln.

E-Mail-Infrastruktur für Unternehmen, KI, Agenten und persönliche E-Mail. Gebaut für Skalierung, Privatsphäre und Kontrolle. Alles, was E-Mail vom ersten Tag an hätte haben sollen.

OpenEmail

E-Mail-Infrastruktur für Unternehmen, KI, Agenten und persönliche E-Mail. Gebaut für Skalierung, Privatsphäre und Kontrolle. Alles, was E-Mail vom ersten Tag an hätte haben sollen.

© 2026 OpenEmail. Alle Rechte vorbehalten.