Install
pip install "gigamail[all]"Para quem
Para quem precisa que um assistente toque e-mail, calendário e arquivos de conhecimento locais sob um modelo de permissões. GigaMail fala MCP; a documentação nomeia Claude, Codex, OpenClaw, Hermes e outros hosts MCP. As capacidades incluem várias contas (Microsoft Graph + IMAP), calendário, um índice de busca local, memória do remetente e controle de permissões voltado ao assistente. Não traz um modelo próprio; a inteligência vem do seu assistente.
Há dois pré-requisitos duros. Primeiro instale o pacote com extras via pip; depois um humano conclui o vínculo da caixa no próprio terminal; o assistente não deve fazer isso. Os comandos de vínculo são gigamail login e gigamail accounts add-imap, e pedem credenciais. Sem login humano primeiro, leituras e escritas seguintes não têm conta a apontar.
Não serve para quem quer que o assistente conclua OAuth ou a digitação da senha IMAP, nem para quem lê “stdio não escuta porta” como “não há nenhum serviço local”: o console humano opcional abre HTTP em 127.0.0.1.
Primeira tentativa em 3 minutos
Instalação oficial:
pip install "gigamail[all]"
A configuração fica em mcpServers no Claude Desktop / Claude Code. command é gigamail-server; não é preciso escrever uma porta. O MCP em si só usa stdio e não escuta porta de rede.
Depois de instalar, saia do assistente e execute gigamail login no seu próprio shell (ou gigamail accounts add-imap para IMAP). A documentação diz que um humano deve fazer isso, e o sistema é desenhado para não ser possível via assistente. Não cole credenciais no chat.
Quando o host sobe o gigamail-server, a primeira passagem é só leitura. A documentação divide as ferramentas em só leitura, escritas seguras auditáveis e 6 ações perigosas. O grupo perigoso inclui send, reply, delete message, delete folder, create/delete calendar event, e precisa de aprovação humana fora de banda. Não toque nesses 6 na primeira tentativa. O sinal de sucesso é uma chamada só leitura devolver resumos de e-mail ou calendário visíveis na sua conta, não um confirmação de envio. Só leitura ainda vê a caixa de entrada real; não é risco zero.
Casos de uso
Caso 1: buscar e-mail ou calendário numa conta já autenticada. A documentação enfatiza o índice de busca local e o acesso controlado à caixa, e menciona um conjunto de ferramentas só leitura. Serve para “primeiro achar uma mensagem” ou “primeiro ver a agenda de hoje”. A documentação existente não nomeia as ferramentas só leitura nem os parâmetros; não invente comandos search ou list. O que se confirma: várias contas, Graph e IMAP, e um índice local existem.
Caso 2: enviar, responder, apagar uma mensagem, apagar uma pasta ou criar/apagar um evento de calendário. Estão marcadas como Dangerous, 6 no total, e exigem aprovação humana fora de banda. Para quando de fato é preciso mudar e-mail ou agenda e há uma pessoa ao lado para confirmar. Antes de chamar, fixe o ponto de confirmação: até um humano aprovar fora de banda, o e-mail não deve sair e o evento não deve ser escrito. A documentação existente não dá interface de aprovação nem tempo limite, nem passos para desfazer um e-mail já enviado.
Limites de uso
O login da caixa não pode ser concluído pelo assistente. O MCP é descrito só como stdio, sem escutar porta, mas o console opcional liga HTTP em 127.0.0.1; não leia isso como “sem rede, sem interface local”. E-mail, calendário e arquivos de conhecimento são dados reais; o modelo de permissões reduz erros, não elimina a leitura.
As ações perigosas são fixas nesses 6 tipos e precisam de aprovação fora de banda. As demais escritas são resumidas como escritas seguras auditáveis e não são nomeadas uma a uma. Não há modelo embutido; a qualidade depende do seu assistente. A documentação existente não tem cotas, limites do fornecedor nem passos completos para remover uma conta. Depois de entregar credenciais ao gigamail login, qualquer host que consiga acionar este MCP pode ler a mesma caixa.