Servidor MCP CoolUtils Mail Viewer

Mail Viewer MCP Server

Um servidor Model Context Protocol que permite que Claude, Cursor, Cline e qualquer agente de IA compatível com MCP leiam, convertam e extraiam anexos de arquivos de e-mail — .eml, .msg, .p7m, .mim, .tnef, .vcf, .olk15 e mais.

O servidor está integrado ao CoolUtils Mail Viewer — não há nada extra para instalar. Execute MailViewer.exe --mcp e o programa ignora sua interface gráfica para atuar como um servidor stdio JSON-RPC.

O que você pode fazer

Depois de conectado, dê instruções em linguagem natural ao seu assistente de IA:

"Converta todos os arquivos .msg em D:\archive para PDF e coloque-os em D:\output" — o agente chama convert_mail em cada arquivo.
"Quais anexos este EML possui e quem o enviou?" — get_mail_info retorna um objeto JSON limpo instantaneamente.
"Extraia todos os anexos destes 40 e-mails para C:\attachments" — extract_attachments salva todos de uma só vez.

Tudo é executado localmente — seus arquivos de e-mail nunca são enviados para lugar nenhum.

Ferramentas

`convert_mail`

Converte um arquivo de e-mail para o formato de saída especificado usando o mecanismo de renderização completo do Mail Viewer.

Formatos de origem: .eml, .msg, .mim, .p7m, .vmbx, .tnef, .mapixml, .olk15, .vcf, .contact, .3uc
Formatos de saída: pdf, html, txt, doc, rtf, tiff, jpg, png, bmp, emf, eml, xps

A saída em PDF e DOCX preserva HTML incorporado, imagens inline, visualizações de anexos e cabeçalhos de mensagem — idêntico ao que você vê na interface gráfica.

`get_mail_info`

Lê um arquivo de e-mail e retorna seus metadados como JSON: remetente, destinatários Para/CC/CCO, assunto, data, cabeçalhos RFC brutos, corpo em texto simples e HTML, e uma lista de anexos com nomes, tamanhos e tipos de conteúdo. O arquivo de origem não é modificado.

`extract_attachments`

Salva todos os anexos de um arquivo de e-mail em uma pasta de destino (criada automaticamente se não existir). Retorna a lista de arquivos salvos com caminhos absolutos e tamanhos em bytes.

Esquemas completos de entrada/saída: schemas/mcp-tools.json.

Instalação

1. Instale o Mail Viewer

Baixe e instale o CoolUtils Mail Viewer para Windows em https://www.coolutils.com/MailViewer. O servidor MCP está incluído no binário padrão MailViewer.exe — sem pacote extra, sem licença separada.

Um teste gratuito de 30 dias está disponível; não é necessário e-mail ou cartão de crédito.

2. Configure seu cliente MCP

Claude Code

Adicione em ~/.claude.json sob mcpServers:

{
  "mcpServers": {
    "mailviewer": {
      "command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe",
      "args": ["--mcp"]
    }
  }
}

Claude Desktop

Adicione em %APPDATA%\Claude\claude_desktop_config.json sob mcpServers (mesmo bloco acima).

Cursor

Adicione em .cursor/mcp.json no seu projeto, ou em ~/.cursor/mcp.json globalmente — mesmo bloco JSON.

Cline

Abra a interface de configurações MCP do Cline e cole o mesmo bloco.

Um trecho pronto para copiar e colar também é instalado junto ao executável como claude-config-snippet.json. Ajuste o caminho se você instalou o Mail Viewer em um local não padrão.

3. Verifique

Execute isto em um prompt de comando para confirmar que o servidor responde:

echo {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}} | "C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe" --mcp

Você deve ver uma única resposta JSON-RPC contendo protocolVersion, serverInfo e uma capacidade tools.

Exemplos de sessões

Veja examples/usage.md para transcrições completas:

Converter uma pasta em lote — aponte o Claude para um diretório de arquivos .msg e peça PDFs.
Triagem forense — peça ao Claude para resumir padrões de remetente/assunto/anexos em 100 e-mails.
Coleta de anexos — extraia todos os anexos de um trimestre de correspondência jurídica para uma única pasta.

Detalhes técnicos

Transporte: stdio (NDJSON, uma mensagem JSON-RPC 2.0 por linha, UTF-8)
Versão do protocolo: 2024-11-05
Nome do servidor (informado em initialize): mailviewer-mcp
Plataforma: Windows 7 / 8 / 10 / 11
Licença: Comercial (Mail Viewer); MIT (este repositório de configuração/documentação). A licença pessoal começa em $49.90, com teste gratuito de 30 dias.

Manifesto do servidor: schemas/mcp-server.json.

Solução de problemas

O servidor não responde. Verifique se o caminho do executável está correto. O caminho de instalação padrão no Windows é C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe. Em instalações de 32 bits, use C:\Program Files (x86)\….

O Claude não encontra as ferramentas. Reinicie seu cliente MCP após editar o arquivo de configuração. Verifique os logs do cliente — para o Claude Desktop, veja %APPDATA%\Claude\logs.

Erros de caminho de arquivo. Use caminhos absolutos em seus prompts. Barras normais (/) e barras invertidas (\) funcionam; coloque entre aspas caminhos com espaços.

Teste expirado. Compre uma licença — a Pessoal começa em $49.90. O servidor MCP continua funcionando no mesmo binário.

Recursos

Licença

Os arquivos de configuração, esquemas e documentação neste repositório são distribuídos sob a Licença MIT. O CoolUtils Mail Viewer em si é um software comercial — consulte a página do produto para licenciamento.

CoolUtils Mail Viewer

Documentação