zoho-mail-mcp

Сервер Model Context Protocol для Zoho Mail. Позволяет Claude (или любому другому MCP-клиенту) читать, искать и отправлять электронную почту из учетной записи Zoho Mail без использования автоматизации браузера.

В официальном реестре MCP нет аналогов — этот сервер заполняет данный пробел.

Инструменты

Related MCP server: claude-gmail-mcp

Предварительные требования

• Учетная запись Zoho Mail

• Node.js 18+

Настройка

1. Создайте OAuth-приложение Zoho

1. Перейдите в консоль Zoho API

2. Создайте приложение типа Self Client

3. В разделе Generate Code добавьте следующие области доступа (scopes):

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

4. Установите срок действия 10 минут, добавьте описание и нажмите Create

5. Скопируйте сгенерированные client_id, client_secret и код авторизации (code)

2. Обменяйте код авторизации на токен обновления (refresh token)

Выполните немедленно (код авторизации истекает через 10 минут):

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"

Сохраните refresh_token из ответа — он не имеет срока действия.

3. Получите ID вашей учетной записи

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

Используйте значение accountId из первого объекта в data[].

4. Установка

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

5. Добавление в Claude Code

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 должен быть подтвержденным адресом или псевдонимом (алиасом) в учетной записи.

Переменные окружения

Примечания

• Токены доступа обновляются автоматически — ручное вмешательство не требуется

• read_email требует наличия как messageId, так и folderId, которые возвращаются инструментами list_inbox и search_emails

• Только REST API — без IMAP/SMTP

Лицензия

MIT