convez.ai
MCP ServerIntegração & APIsIntermediário
SirGreed808

Zoho Mail MCP

SirGreed808/zoho-mail-mcp

Acesso programático a Zoho Mail via Claude — ler, buscar e enviar emails

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra Zoho Mail ao Claude, permitindo ler, buscar e enviar emails programaticamente sem automação de navegador. Oferece acesso via REST API com autenticação OAuth2, ideal para automação de fluxos de email em conversas com o Claude.

Instalação

$npx convez-ai SirGreed808/zoho-mail-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de leitura e resposta de emails em fluxos de trabalho
  • Busca e extração de informações de emails para análise
  • Envio automático de emails como parte de automações mais complexas

Veredito

Implementação sólida de integração com Zoho Mail via MCP, preenchendo uma lacuna no registry oficial. Setup requer configuração OAuth2 e variáveis de ambiente, mas funcionalidade essencial está bem definida (listar, buscar, ler, enviar). Recomendado para quem precisa automação de email em Zoho sem overhead de browser automation.

README

A tradução para o português deste README ainda está na fila.

zoho-mail-mcp

A Model Context Protocol server for Zoho Mail. Lets Claude (or any MCP client) read, search, and send email from a Zoho Mail account without browser automation.

No equivalent exists in the official MCP registry — this fills that gap.

Tools

ToolDescription
list_inboxList recent inbox messages — returns sender, subject, date, messageId, folderId
search_emailsSearch by keyword, sender email, or subject fragment
read_emailRead full email body given a messageId and folderId
send_emailSend an email from your configured sender address

Prerequisites

Setup

1. Create a Zoho OAuth app

  1. Go to Zoho API Console
  2. Create a Self Client application
  3. Under Generate Code, add these scopes:
    ZohoMail.messages.READ,ZohoMail.messages.CREATE,ZohoMail.folders.READ,ZohoMail.accounts.READ
    
  4. Set expiry to 10 minutes, add a description, click Create
  5. Copy the generated client_id, client_secret, and grant code

2. Exchange the grant code for a refresh token

Run immediately (grant code expires in 10 minutes):

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"

Save the refresh_token from the response — it doesn't expire.

3. Get your account ID

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

Use the accountId value from the first object in data[].

4. Install

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

5. Add to 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 must be a verified address or alias on the account.

Environment Variables

VariableDescription
ZOHO_CLIENT_IDOAuth app client ID
ZOHO_CLIENT_SECRETOAuth app client secret
ZOHO_REFRESH_TOKENLong-lived refresh token (from step 2)
ZOHO_ACCOUNT_IDZoho Mail account ID (from step 3)
ZOHO_SENDEREmail address to send from

Notes

  • Access tokens are refreshed automatically — no manual intervention needed
  • read_email requires both messageId and folderId, both returned by list_inbox and search_emails
  • Only REST API — no IMAP/SMTP

License

MIT

Ver o original no GitHub

Bom para

Relacionados