Verbinden Sie Ihr Postfach mit Gemini CLI
mit einem Eintrag in den Einstellungen
Geben Sie der Gemini CLI ein echtes Postfach. E-Mails aus dem Terminal lesen, suchen, senden, beantworten, weiterleiten, planen und organisieren, über alle verbundenen Postfächer hinweg.
Fügen Sie in ~/.gemini/settings.json unter mcpServers einen Eintrag mit dem Feld httpUrl und https://mcpemails.com/api/mcp hinzu. Bei der ersten Verbindung liest die CLI die OAuth-Metadaten aus und öffnet den Ablauf im Browser von selbst.
So verbindet sich Gemini CLI: OAuth, kein API-Schlüssel
Gemini CLI durchläuft mit diesem Server den standardmäßigen MCP-OAuth-Ablauf. Der Client registriert sich selbst 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 Gemini CLI 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 Gemini CLI 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.
settings.json öffnen
Bearbeiten Sie ~/.gemini/settings.json für alle Projekte oder .gemini/settings.json innerhalb eines Projekts.
Server hinzufügen
Fügen Sie den Eintrag unten unter mcpServers hinzu. Das Feld für einen Streamable-HTTP-Server heißt hier httpUrl.
Verbinden
Bei der ersten Verbindung erkennt die CLI OAuth automatisch anhand der Server-Metadaten und öffnet den Ablauf im Browser. Geben Sie die Scopes frei, die die CLI erhalten soll.
{
"mcpServers": {
"mcpemails": {
"httpUrl": "https://mcpemails.com/api/mcp"
}
}
}Offizielle Dokumentation von Gemini CLI zu entfernten MCP-Servern: https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md
Unsicher, welches Postfach Sie zuerst verbinden sollen? Zur Kompatibilitätsübersicht der Anbieter
Typische Stolperfallen in Gemini CLI
httpUrl ist ein anderes Feld als url, und der Unterschied ist der Transport
In den Einstellungen der Gemini CLI steht httpUrl für einen Streamable-HTTP-Server, und das ist dieser hier. Andere Schlüssel im selben Objekt wählen andere Transporte. Ein Snippet aus einer Cursor-Anleitung, die url verwendet, ergibt hier keine funktionierende Streamable-HTTP-Verbindung.
Die Discovery macht das konfigurationsfrei, und sie beginnt mit einer 401
Der CLI muss niemand sagen, wo sie sich authentifizieren soll. Ein nicht authentifizierter Aufruf erhält eine 401, deren Header WWW-Authenticate auf unsere Metadaten zur geschützten Ressource verweist. Diese nennen den Autorisierungsserver, und dessen Metadaten nennen die Endpunkte für Registrierung, Autorisierung und Token. Deshalb müssen Sie keine Client-ID anlegen und außer der URL nichts einfügen.
Eine CLI auf einem geteilten Rechner oder ohne Oberfläche braucht stattdessen den Weg über Schlüssel
Der Ablauf im Browser braucht einen Browser. Auf einem Build-Agenten oder einem geteilten Rechner ist ein Bearer-API-Schlüssel das ehrliche Setup, mit genau den Scopes, die diese Automatisierung braucht, und abgelegt in der Umgebung statt in einer committeten Einstellungsdatei.
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.
Gemini CLI und E-Mail: Fragen und Antworten
Wie verbinde ich meine E-Mails mit Gemini CLI?
Fügen Sie in ~/.gemini/settings.json unter mcpServers einen Eintrag hinzu, bei dem httpUrl auf https://mcpemails.com/api/mcp gesetzt ist. Bei der ersten Verbindung erkennt die CLI OAuth anhand der Server-Metadaten und öffnet den Ablauf im Browser. Danach hat sie Tools zum Lesen, Suchen, Senden, Beantworten, Weiterleiten, Organisieren und Planen von E-Mails.
Soll ich url oder httpUrl verwenden?
httpUrl. In den Einstellungen der Gemini CLI wählt dieser Schlüssel den Streamable-HTTP-Transport, und den spricht dieser Server. Ein aus einem anderen Client kopierter url-Eintrag ist der übliche Grund, warum der Server in der Liste erscheint, aber keine Tools liefert.
Ist das derselbe Gmail-MCP-Server, den Google veröffentlicht?
Nein. Google veröffentlicht einen Workspace-MCP-Server, der Gmail neben seinen anderen Diensten abdeckt, und für Gmail allein in einem reinen Google-Workflow ist das der kürzere Weg. MCPEmails ist für den Fall gedacht, dass nicht alle Postfächer bei Google liegen und dieselbe URL auch in Claude, Cursor und ChatGPT funktionieren muss.
Welche Postfächer erreicht Gemini CLI 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 Gemini CLI E-Mails senden, ohne dass ich es mitbekomme?
Nur wenn Sie es zulassen. Senden erfordert den Scope send:email, ein Schlüssel oder 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 Gemini CLI ein echtes Postfach
Ein Eintrag in den Einstellungen, eine Anmeldung. Ein Postfach dauerhaft kostenlos, keine Kreditkarte nötig.