Verbinden Sie Ihr Postfach mit OpenAI Codex
mit einem einzigen Befehl
Geben Sie Codex ein echtes Postfach. E-Mails lesen, suchen, entwerfen, senden, beantworten, weiterleiten, planen und organisieren, aus der Codex CLI, der IDE-Erweiterung oder der ChatGPT-Desktop-App, über alle verbundenen Postfächer hinweg.
Führen Sie codex mcp add mcpemails --url https://mcpemails.com/api/mcp aus. Codex erkennt, dass der Server OAuth unterstützt, öffnet den Browser, und Sie geben den Zugriff auf dem Zustimmungsbildschirm von MCPEmails frei. CLI, IDE-Erweiterung und ChatGPT-Desktop-App teilen sich dieselbe Konfiguration, eine Einrichtung deckt also alle drei ab.
So verbindet sich Codex: OAuth, kein API-Schlüssel
Codex durchläuft mit diesem Server den standardmäßigen MCP-OAuth-Ablauf. Der Client registriert sich selbst, entweder über ein Client-ID-Metadatendokument oder per dynamischer Client-Registrierung nach RFC 7591, Sie müssen also keine Client-ID anlegen, und autorisiert sich per Autorisierungscode mit PKCE (S256). Ein Client-Secret wird nie übertragen, und das Token enthält nur die Scopes, die Sie auf unserem Zustimmungsbildschirm freigeben. Das Zugriffstoken gilt eine Stunde und erneuert sich selbst. Sie finden es unter Dashboard, API-Schlüssel als OAuth: mit dem Namen des Clients dahinter, und dort widerrufen Sie die Verbindung auch.
Der eine Wert, den Sie brauchen
Alles auf dieser Seite dient dazu, diese URL in OpenAI Codex einzutragen.
| Feld | Wert |
|---|---|
| MCP-Server-URL | https://mcpemails.com/api/mcp |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Authentifizierung | OAuth 2.1, Autorisierungscode mit PKCE. Kein API-Schlüssel. |
So verbinden Sie OpenAI Codex mit Ihrem Postfach
Vier Schritte. Die ersten beiden sind bei jedem Client gleich, die übrigen gelten speziell für diesen.
Kostenloses Konto erstellen und Postfach verbinden
Registrieren Sie sich auf mcpemails.com, ohne Kreditkarte, und öffnen Sie dann Dashboard, Postfächer, Postfach verbinden. Outlook und Microsoft 365 verbinden Sie über „Mit Microsoft anmelden“; Gmail, iCloud, Fastmail, Yahoo, Zoho und Yandex nutzen ein App-Passwort; alle anderen Postfächer verbinden sich ganz normal per IMAP und SMTP. Der Free-Tarif umfasst ein Postfach, dauerhaft.
Server über die CLI hinzufügen
Führen Sie den Befehl unten aus. Er schreibt einen Eintrag [mcp_servers.mcpemails] mit url in ~/.codex/config.toml, gibt dann Detected OAuth support. Starting OAuth flow… aus und öffnet Ihren Browser.
Oder in der Desktop-App bzw. IDE-Erweiterung hinzufügen
Öffnen Sie in der ChatGPT-Desktop-App Settings und dann MCP servers; in der IDE-Erweiterung öffnen Sie das Zahnradmenü und dann MCP servers. Wählen Sie Add server, geben Sie einen Namen ein, wählen Sie Streamable HTTP, fügen Sie https://mcpemails.com/api/mcp ein, speichern Sie und wählen Sie dann Restart (bzw. Restart extension) und Authenticate.
Zugriff freigeben
Melden Sie sich im Browser bei MCPEmails an, wählen Sie auf dem Zustimmungsbildschirm Nur-Lese-Zugriff, Standard oder Vollzugriff und klicken Sie auf Zugriff erlauben. Ist der Ablauf im Browser nicht gestartet, führen Sie codex mcp login mcpemails aus.
Prüfen und etwas fragen
Führen Sie codex mcp list aus, oder /mcp in einer Codex-Sitzung, um den Server zu sehen. Probieren Sie dann „Fasse alles Ungelesene von heute zusammen“. Codex ruft zuerst inbox_list auf und findet so Ihre Postfächer, Sie müssen also keine IDs einfügen.
codex mcp add mcpemails --url https://mcpemails.com/api/mcpOffizielle Dokumentation von OpenAI Codex zu entfernten MCP-Servern: https://learn.chatgpt.com/docs/extend/mcp?surface=cli
Unsicher, welches Postfach Sie zuerst verbinden sollen? Zur Kompatibilitätsübersicht der Anbieter
Typische Stolperfallen in Codex
Prüfen Sie, welche Karte der Zustimmungsbildschirm zuerst anzeigt
Codex fordert die Scopes aus unserer 401-Challenge an, und das ist read:email. Bei manchen Registrierungen zeigt der Zustimmungsbildschirm deshalb zuerst Nur-Lese-Zugriff an. Zum Sichten genügt das. Soll Codex auch entwerfen oder senden, wählen Sie Standard oder Vollzugriff, bevor Sie auf Zugriff erlauben klicken. Um den Zugriff später zu erweitern, führen Sie codex mcp login mcpemails erneut aus und wählen die umfassendere Karte, oder Sie nennen die Scopes mit --scopes, zum Beispiel --scopes read:email,search:email,manage:drafts.
CLI, IDE-Erweiterung und Desktop-App teilen sich eine Konfiguration
Auf demselben Rechner lesen alle drei dieselbe ~/.codex/config.toml. Fügen Sie den Server in einem davon hinzu, erscheint er also auch in den anderen. Ein Projekt kann zusätzlich eine eigene .codex/config.toml mitbringen, die Codex nur bei vertrauenswürdigen Projekten liest. ChatGPT im Web liest diese Datei überhaupt nicht; dafür nutzen Sie die Anleitung für ChatGPT.
Auf einem Rechner ohne grafische Oberfläche den lokalen Browser überspringen
Auf einem Server, den Sie per SSH erreichen, führen Sie codex mcp login mcpemails --no-browser aus: Codex gibt den Anmeldelink aus, Sie öffnen ihn auf einem beliebigen Rechner und fügen die Adresse, auf der der Browser landet, in Codex wieder ein. In CI erstellen Sie unter Dashboard, API-Schlüssel einen Schlüssel mit Scopes, exportieren ihn und setzen bearer_token_env_var im Server-Eintrag auf den Namen dieser Variable (oder übergeben --bearer-token-env-var an codex mcp add). Codex sendet ihn dann im Header Authorization, und der Schlüssel steht nie in der Konfigurationsdatei.
Behalten Sie das Standard-Timeout für Tools bei
Codex wartet standardmäßig 60 Sekunden auf einen Tool-Aufruf (tool_timeout_sec). Das reicht auch für Massenoperationen: Wer Nachrichten in einem großen Ordner verschiebt oder löscht, stößt vorher an das eigene Zeitlimit des Servers und erhält ein Ergebnis mit der Markierung partial, in dem die noch nicht bearbeiteten Nachrichten unter remaining_message_ids stehen. Codex kann das Tool also mit diesen IDs erneut aufrufen. Ein deutlich niedrigeres Timeout kann einen Aufruf abbrechen, bevor dieses Ergebnis ankommt.
Wichtige Grenzen
- Anfragen sind auf 100 pro Minute, 1.000 pro Stunde und 10.000 pro Tag je Schlüssel begrenzt, dazu kommt die Obergrenze Ihres Tarifs für abrechenbare Aktionen.
- Der Server arbeitet rein nach Anfrage und Antwort. Es gibt keine Webhooks und keine vom Server ausgelösten Ereignisse, neue E-Mails wecken Ihren Agenten also nie von selbst. Um auf eingehende E-Mails zu reagieren, fragen Sie in festen Abständen ab.
- E-Mails werden bei jedem Aufruf live von Ihrem Anbieter abgerufen und nie gespeichert. Gespeichert wird nur das verschlüsselte OAuth-Token oder App-Passwort. Ein widerrufenes Token oder ein geändertes Postfachpasswort beendet den Zugriff deshalb sofort.
OpenAI Codex und E-Mail: Fragen und Antworten
Wie verbinde ich meine E-Mails mit OpenAI Codex?
Führen Sie codex mcp add mcpemails --url https://mcpemails.com/api/mcp aus. Codex erkennt die OAuth-Unterstützung, öffnet den Browser, und Sie geben den Zugriff auf dem Zustimmungsbildschirm von MCPEmails frei. Danach hat Codex Tools zum Lesen, Suchen, Entwerfen, Senden, Beantworten, Weiterleiten, Organisieren und Planen von E-Mails.
Wie sieht der Eintrag in config.toml aus?
Zwei Zeilen in ~/.codex/config.toml: eine Tabelle namens [mcp_servers.mcpemails] und url = "https://mcpemails.com/api/mcp". Für einen Server mit url ist OAuth die Voreinstellung, mehr ist also nicht nötig. Wenn Sie den Eintrag von Hand schreiben, führen Sie codex mcp login mcpemails aus, um sich anzumelden.
Brauche ich für Codex einen API-Schlüssel?
Nein. Codex meldet sich per OAuth an, es wird also nichts Geheimes in die Konfiguration eingetippt. Ein Schlüssel mit Scopes ist für Rechner ohne Browser gedacht: Speichern Sie ihn in einer Umgebungsvariable und lassen Sie bearer_token_env_var auf diese Variable zeigen.
Welche Postfächer erreicht Codex auf diesem Weg?
Outlook.com und Microsoft 365 über „Mit Microsoft anmelden“, wobei bei einem Arbeitskonto eventuell einmalig die IT-Administration die App freigeben muss; Gmail, iCloud, Fastmail, Yahoo, Zoho und Yandex mit einem App-Passwort; und jedes andere Postfach, das IMAP und SMTP auf den Standardports spricht. Der Client sieht alle über dieselbe Verbindung: Ihr Agent ruft zuerst inbox_list auf und findet so jedes verbundene Postfach samt ID. Sie müssen also nirgends UUIDs einfügen.
Kann Codex E-Mails senden, ohne dass ich es mitbekomme?
Nur wenn Sie es zulassen. Senden erfordert den Scope send:email, ein Token ohne diesen Scope kann also überhaupt nicht senden. Zusätzlich kann der Inhaber eines Postfachs im Dashboard eine menschliche Freigabe verlangen. Dann wartet jedes Senden, Antworten, Weiterleiten, Senden eines Entwurfs und geplante Senden, bis eine Person es freigibt.
Werden meine E-Mails auf Ihren Servern gespeichert?
Nein. Jede Nachricht wird für die Anfrage, die sie anfordert, live von Ihrem Anbieter abgerufen und direkt an Ihren Client übergeben. Gespeichert wird nur das verschlüsselte OAuth-Token oder App-Passwort, damit spätere Aufrufe sich authentifizieren können. Wenn Sie das Postfach im Dashboard löschen oder den Zugriff bei Ihrem Anbieter widerrufen, endet die Verbindung sofort.
Geben Sie Codex ein echtes Postfach
Ein Befehl, eine Anmeldung im Browser. Ein Postfach dauerhaft kostenlos, keine Kreditkarte nötig.