yt-zoho-mcp

Servidor MCP para Zoho Mail — busca, lee, envía y gestiona mensajes en todas las carpetas.

Implementa la especificación del Model Context Protocol: se ejecuta sobre el transporte stdio, habla JSON-RPC 2.0, negocia la versión del protocolo en initialize, anuncia capacidades de tools y describe cada herramienta con un JSON Schema. La negociación de la versión del protocolo la gestiona la clase Server de @modelcontextprotocol/sdk, que por defecto usa la última versión compatible.

Tools

Related MCP server: zoho-mail-mcp

Configuración inicial

1. Crea un cliente de API de Zoho Mail

1. Ve a Zoho API Console

2. Crea un Self Client (o una aplicación basada en servidor)

3. Copia el client_id y el client_secret

4. Genera un token OAuth con el alcance offline para obtener un refresh_token:

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

5. Encuentra tu account_id mediante el endpoint Get Accounts y anota tu dirección de correo electrónico (p. ej. you@example.com).

2. Coloca las credenciales

Al instalar el paquete se crea automáticamente el directorio de configuración ~/.yt-zoho-mcp (llamado así por el paquete npm, yt-zoho-mcp) mediante un script postinstall. Coloca credentials.json en él:

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

El servidor renueva automáticamente el token de acceso a partir de refreshToken en cada llamada (y lo vuelve a renovar ante un 401).

Configuración

Configuración del host MCP

opencode

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

Claude Desktop

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

Licencia

MIT