yt-zoho-mcp

MCP-сервер для Zoho Mail — поиск, чтение, отправка и управление сообщениями в папках.

Реализует спецификацию Model Context Protocol: работает поверх транспорта stdio, использует JSON-RPC 2.0, согласует версию протокола при вызове initialize, объявляет возможности tools и описывает каждый инструмент с помощью JSON Schema. Согласование версии протокола обрабатывается классом Server из @modelcontextprotocol/sdk, который по умолчанию использует последнюю поддерживаемую версию.

Инструменты

Related MCP server: zoho-mail-mcp

Настройка

1. Создайте API-клиент Zoho Mail

1. Перейдите в Zoho API Console

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

3. Скопируйте client_id и client_secret

4. Сгенерируйте OAuth-токен с областью offline, чтобы получить refresh_token:

   virtualoffice.accounts.read
   virtualoffice.messages.read
   virtualoffice.messages.create
   virtualoffice.messages.update
   virtualoffice.messages.delete

5. Найдите свой account_id с помощью эндпоинта Get Accounts и запишите свой адрес электронной почты (например, you@example.com).

2. Разместите учётные данные

Установка пакета автоматически создаёт каталог конфигурации ~/.yt-zoho-mcp (названный в честь npm-пакета yt-zoho-mcp) с помощью сценария postinstall. Поместите credentials.json в этот каталог:

{
  "clientId": "...",
  "clientSecret": "...",
  "refreshToken": "...",
  "accountId": "...",
  "email": "you@example.com"
}

Сервер автоматически обновляет токен доступа из refreshToken при каждом вызове (и повторно обновляет его при получении ответа 401).

Конфигурация

Конфигурация MCP-хоста

opencode

{
  "mcp": {
    "zoho-mail": {
      "type": "local",
      "command": ["npx", "yt-zoho-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "zoho-mail": {
      "command": "npx",
      "args": ["yt-zoho-mcp"]
    }
  }
}

Лицензия

MIT