zoho-mail-mcp

Ein Model Context Protocol-Server für Zoho Mail. Ermöglicht es Claude (oder jedem anderen MCP-Client), E-Mails von einem Zoho Mail-Konto zu lesen, zu durchsuchen und zu versenden, ohne Browser-Automatisierung.

Es gibt kein Äquivalent im offiziellen MCP-Register – dies schließt diese Lücke.

Tools

Related MCP server: claude-gmail-mcp

Voraussetzungen

• Ein Zoho Mail-Konto

• Node.js 18+

Einrichtung

1. Erstellen einer Zoho OAuth-App

1. Gehen Sie zur Zoho API Console

2. Erstellen Sie eine Self Client-Anwendung

3. Fügen Sie unter Generate Code diese Scopes hinzu:

   ZohoMail.messages.READ,ZohoMail.messages.CREATE,ZohoMail.folders.READ,ZohoMail.accounts.READ

4. Setzen Sie die Ablaufzeit auf 10 Minuten, fügen Sie eine Beschreibung hinzu und klicken Sie auf Create

5. Kopieren Sie die generierte client_id, das client_secret und den code (Grant Code)

2. Tauschen Sie den Grant Code gegen ein Refresh Token

Führen Sie dies sofort aus (der Grant Code läuft nach 10 Minuten ab):

curl -X POST https://accounts.zoho.com/oauth/v2/token \
  -d "grant_type=authorization_code" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "code=YOUR_GRANT_CODE"

Speichern Sie das refresh_token aus der Antwort – es läuft nicht ab.

3. Ermitteln Sie Ihre Konto-ID

curl -X GET https://mail.zoho.com/api/accounts \
  -H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN"

Verwenden Sie den accountId-Wert aus dem ersten Objekt in data[].

4. Installation

git clone https://github.com/SirGreed808/zoho-mail-mcp
cd zoho-mail-mcp
npm install

5. Zu Claude Code hinzufügen

claude mcp add --scope user \
  -e "ZOHO_CLIENT_ID=..." \
  -e "ZOHO_CLIENT_SECRET=..." \
  -e "ZOHO_REFRESH_TOKEN=..." \
  -e "ZOHO_ACCOUNT_ID=..." \
  -e "ZOHO_SENDER=you@yourdomain.com" \
  zoho-mail -- node /absolute/path/to/zoho-mail-mcp/index.js

ZOHO_SENDER muss eine verifizierte Adresse oder ein Alias des Kontos sein.

Umgebungsvariablen

Hinweise

• Zugriffstoken werden automatisch aktualisiert – kein manuelles Eingreifen erforderlich

• read_email erfordert sowohl messageId als auch folderId, die beide von list_inbox und search_emails zurückgegeben werden

• Nur REST-API – kein IMAP/SMTP

Lizenz

MIT