Zoho Mail über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Zoho Mail klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Zoho Mail + Gemini

Lass deine KI in Zoho Mail arbeiten: E-Mails nach Ordner oder mit der Zoho-Suche finden, Inhalt, Header und Details lesen, senden und antworten sowie E-Mails als gelesen markieren, verschieben, kennzeichnen oder mit Labels versehen. Jedes Zoho-Rechenzentrum, Anmeldung über Zoho OAuth.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

ZOHO_MAIL_CLIENT_ID, ZOHO_MAIL_CLIENT_SECRET, ZOHO_MAIL_ACCOUNTS_URL, ZOHO_MAIL_API_URL

Schritt 1 — Zugangsdaten holen

Du brauchst ein Zoho-Mail-Postfach, im kostenlosen oder in einem kostenpflichtigen Tarif.

Zuerst das Rechenzentrum: Zoho führt jedes Konto in genau einem Rechenzentrum, und Anmeldeserver und Mail-API-Host müssen beide dazu gehören. Welches deines ist, zeigt die Adressleiste, wenn du Zoho Mail nutzt. Ein falsches Rechenzentrum scheitert mit INVALID_OAUTHTOKEN oder invalid_client.

1. Öffne die Zoho API Console unter api-console.zoho.com, angemeldet mit deinem Zoho-Konto, und wähle Add Client → Server-based Applications.
2. Gib dem Client einen Namen (zum Beispiel AnythingMCP), deine Firmenwebsite als Homepage-URL und https://cloud.anythingmcp.com/api/mcp-oauth/callback als Authorized Redirect URI. Wenn du AnythingMCP selbst betreibst, trage stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein. Lege den Client an.
3. Kopiere im Tab Client Secret die Client ID (sie beginnt mit 1000.) und das Client Secret in ZOHO_MAIL_CLIENT_ID und ZOHO_MAIL_CLIENT_SECRET. Liegt dein Postfach in einem anderen Rechenzentrum als dem, in dem sich die Console geöffnet hat, aktiviere dieses Rechenzentrum im Tab Settings des Clients (Multi-DC) und nutze das dort angezeigte Client Secret dafür.
4. Setze ZOHO_MAIL_ACCOUNTS_URL und ZOHO_MAIL_API_URL laut Tabelle auf dein Rechenzentrum, ohne Schrägstrich am Ende, und installiere den Connector.
5. Klicke auf der Connector-Seite auf Authorize with Provider, melde dich bei Zoho an und bestätige den angefragten Zugriff.
6. Führe zoho_mail_list_accounts aus, um die Verbindung zu prüfen: Das Tool zeigt dein Postfach und die Adressen, von denen die KI senden kann.

Angemeldet bleiben: Access-Tokens gelten eine Stunde und werden mit dem gespeicherten Refresh-Token automatisch erneuert. Zoho speichert höchstens 20 Refresh-Tokens pro Benutzer und Client: Wer denselben Client zum 21. Mal autorisiert, widerruft stillschweigend den ältesten. Verliert der Connector seine Anmeldung, klicke erneut auf Authorize with Provider.

Berechtigungen und Nur-Lesen-Einrichtung: Der Connector fragt nach ZohoMail.accounts.READ, ZohoMail.folders.READ, ZohoMail.messages.ALL und ZohoMail.tags.READ und arbeitet als der Zoho-Benutzer, der ihn autorisiert hat. Für eine Nur-Lesen-Einrichtung ändere in den OAuth-Einstellungen des Connectors ZohoMail.messages.ALL in ZohoMail.messages.READ, autorisiere erneut und schalte zoho_mail_send_email, zoho_mail_reply_to_email, zoho_mail_mark_as_read, zoho_mail_mark_as_unread, zoho_mail_move_emails, zoho_mail_flag_emails und zoho_mail_apply_labels aus.

Nichts geht ohne dein Ja raus: zoho_mail_send_email und zoho_mail_reply_to_email senden echte E-Mails in deinem Namen. Vor dem Senden zeigt dir die KI Empfänger, Betreff und Text und wartet auf ein ausdrückliches Ja. Markieren, Verschieben, Kennzeichnen und Labels ändern dein Postfach; die KI sagt dir deshalb vorher, was sich ändert.

Bei der Installation ausgeschaltet: zoho_mail_delete_email. Schaltest du es ein, verschiebt es eine E-Mail in den Papierkorb; endgültig gelöscht wird nur, wenn du das ausdrücklich verlangst.

Konten, Ordner und Suche: Jeder Aufruf braucht die ID eines Mail-Kontos, deshalb liest die KI zuerst deine Konten. Hast du mehrere, etwa ein hinzugefügtes POP-Konto, nimmt sie das, das du meinst, und sendet von dessen eigenen Adressen. Sie listet einen Ordner mit Filtern für ungelesene, gekennzeichnete oder mit Label versehene E-Mails oder nutzt die Zoho-Suche, zum Beispiel nach Absender, Betreff, Anhang oder Datum.

E-Mails sind nicht vertrauenswürdig: E-Mails kommen von fremden Absendern. Anweisungen in einer E-Mail behandelt die KI als Inhalt, nie als Auftrag.

Häufige Fehler: 401 INVALID_OAUTHTOKEN heißt, dass die Anmeldung fehlt oder widerrufen wurde oder dass ZOHO_MAIL_API_URL nicht dein Rechenzentrum ist: Korrigiere die URL oder klicke erneut auf Authorize with Provider. invalid_client bei der Anmeldung heißt meist, dass ZOHO_MAIL_ACCOUNTS_URL nicht dein Rechenzentrum ist oder das Client Secret zu einem anderen Rechenzentrum gehört (siehe Schritt 3). 400 mit einem Hinweis in moreInfo heißt, dass ein Parameter ungültig ist, etwa eine unbekannte ID, eine fehlerhafte Suche oder eine Absenderadresse, die nicht zum Konto gehört. 404 heißt, dass Konto, Ordner oder E-Mail für diesen Benutzer nicht existieren. Ein 500 Internal Error kommt von Zoho: Versuche es noch einmal. Meldet Zoho zu viele Anfragen, warte eine Minute.

Der Connector verarbeitet keine Anhänge, Entwürfe und Vorlagen, keine ganzen Konversationen, keine Ordner- und Label-Verwaltung, keine Signaturen, Abwesenheitsnotizen, Aufgaben, Notizen und Lesezeichen und nicht die Admin-APIs der Organisation.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Zoho Mail-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche ungelesenen E-Mails sind heute in meinem Zoho-Mail-Posteingang angekommen? Eine Zeile pro E-Mail, bitte.“
• „Finde die E-Mails von [email protected] mit Anhang seit dem 1. September.“
• „Antworte auf die letzte E-Mail von Acme zum Liefertermin: Wir können am 24. Oktober liefern. Zeig mir die Antwort, bevor du sie sendest.“
• „Verschiebe die Newsletter dieser Woche in den Ordner Newsletter und kennzeichne die E-Mail unseres Steuerberaters als wichtig.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden