Conecte sua caixa de entrada ao OpenClaw
como um servidor MCP remoto
Deixe o agente pessoal com quem você já troca mensagens ler, pesquisar, rascunhar, enviar, responder, encaminhar e arquivar e-mails em todas as caixas de entrada que você conectou, por um único endpoint MCP e um único login.
O único valor de que você precisa
Pare o Gateway com openclaw gateway stop, rode openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauth, depois openclaw mcp login mcpemails e aprove no navegador. Inicie o Gateway de novo com openclaw gateway start.
| Campo | Valor |
|---|---|
| URL do servidor MCP | https://mcpemails.com/api/mcp |
| Transporte | Streamable HTTP (MCP 2025-06-18) |
| Autenticação | OAuth 2.1, código de autorização com PKCE. Sem chave de API. |
Como o OpenClaw se conecta: OAuth, sem chave de API
O cliente MCP nativo do OpenClaw executa o fluxo OAuth padrão do MCP para um servidor HTTP salvo com auth: "oauth". Ele se registra com registro dinâmico de cliente RFC 7591, então não há client ID para criar, e autoriza com authorization code mais PKCE usando S256. O token carrega só os escopos que você aprova na nossa tela de consentimento, dura uma hora e se renova sozinho. O OpenClaw o guarda no Gateway, e ele aparece no painel, em Chaves de API, como OAuth: OpenClaw MCP, e é ali que você revoga a conexão.
Como conectar o OpenClaw à sua caixa de entrada
Quatro passos. Os dois primeiros são iguais para todos os clientes, os demais são específicos deste.
Crie uma conta grátis e conecte uma caixa de correio
Crie sua conta em mcpemails.com, sem cartão, e conecte sua caixa de correio no painel, em Caixas de entrada. Uma caixa de entrada é grátis, para sempre.
Salve o servidor com OAuth
Na máquina que roda o seu Gateway, rode openclaw gateway stop e depois openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauth. Isso grava a entrada em mcp.servers no ~/.openclaw/openclaw.json. O OpenClaw se recusa a alterar servidores salvos enquanto o Gateway está rodando.
Faça login pelo terminal
Com o Gateway ainda parado, rode openclaw mcp login mcpemails. Siga a URL de autorização mostrada e aprove os escopos que você quer que o OpenClaw tenha. O OpenClaw captura o callback do navegador e salva as credenciais; depois rode openclaw gateway start.
Ou faça login pela Control UI
Em vez do login pelo terminal, inicie o Gateway e abra a Control UI no próprio endereço de loopback dela ou num endereço HTTPS público, depois vá em Settings → MCP. Como administrador, selecione Sign in no servidor mcpemails, aprove o acesso no navegador e volte para Settings. Num endereço privado ou só do Tailscale, use o login pelo terminal.
Confira a conexão
Rode openclaw mcp status --verbose, que funciona com o Gateway rodando. Se aparecer authorization-required, faça login de novo. Depois peça ao seu agente, em qualquer canal, que liste suas caixas de entrada.
openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauthDocumentação oficial do OpenClaw sobre servidores MCP remotos: https://docs.openclaw.ai/tools/mcp
Na dúvida sobre qual caixa de correio conectar primeiro? Veja a tabela de compatibilidade de provedores
Onde as pessoas costumam tropeçar no OpenClaw
Defina o transporte, senão ele volta para SSE
Quando transport fica de fora de uma entrada HTTP, o OpenClaw usa sse. Este servidor usa Streamable HTTP, então sempre passe --transport streamable-http, ou escolha Streamable HTTP em Settings. Numa configuração escrita à mão, transport: "streamable-http" é a grafia que o OpenClaw lê; um type: "http" no estilo do CLI só é aceito via openclaw mcp set ou corrigido por openclaw doctor --fix.
Mudanças pelo CLI exigem o Gateway parado
openclaw mcp add, login, probe e doctor --probe se recusam a rodar enquanto um Gateway local controla o estado do OpenClaw, então pare-o antes e inicie de novo depois. Se o Gateway roda num servidor e o seu navegador está em outro lugar, o callback de loopback não chega até ele: copie o código do navegador e conclua com o comando openclaw mcp login mcpemails --code mostrado.
Login compartilhado significa caixa de correio compartilhada
Por padrão, a credencial OAuth é compartilhada e gerenciada pelo operador: todos os agentes naquele Gateway usam o mesmo login, então qualquer pessoa que consiga mandar mensagem ao seu agente pode pedir que ele leia seus e-mails. Restrinja a canais que só você usa, deixe send:email fora da tela de consentimento se o agente só deve ler, ou ative a aprovação humana na caixa de entrada para que todo envio espere por uma pessoa. O OpenClaw também oferece login por solicitante, em que cada remetente conecta a própria conta; isso exige gateway.publicOrigin definido com o endereço HTTPS público do Gateway.
Um servidor salvo não é um servidor funcionando
O OpenClaw salva uma definição sem provar que ela funciona, e um servidor que ainda precisa de login simplesmente fica fora das ferramentas do agente, em vez de fazer a rodada falhar. Se o agente disser que não tem ferramentas de e-mail, rode openclaw mcp status --verbose: authorization-required significa que você precisa repetir o passo de login.
Limites que vale a pena conhecer
- As solicitações têm limite de 100 por minuto, 1.000 por hora e 10.000 por dia por chave.
- O servidor funciona só com solicitação e resposta. Não há webhooks nem eventos iniciados pelo servidor, então um e-mail novo nunca acorda seu agente sozinho. Para reagir a e-mails que chegam, faça polling em intervalos programados.
- Os e-mails são buscados ao vivo no seu provedor a cada chamada e nunca armazenados. Só o token OAuth ou a senha de app criptografados ficam guardados, então um token revogado ou uma senha da caixa de correio alterada encerra o acesso na hora.
OpenClaw e e-mail: perguntas e respostas
Como conecto o e-mail ao OpenClaw?
Na máquina do Gateway, pare o Gateway, rode openclaw mcp add mcpemails --url https://mcpemails.com/api/mcp --transport streamable-http --auth oauth, depois faça login com openclaw mcp login mcpemails e inicie o Gateway de novo. Você também pode fazer login em Settings, MCP, na Control UI. Seu agente passa a ter ferramentas para ler, pesquisar, rascunhar, enviar, responder, encaminhar, organizar e agendar e-mails.
Preciso de uma chave de API para o OpenClaw?
Não. O OpenClaw executa o fluxo OAuth do MCP sozinho e guarda o token no Gateway. As entradas HTTP dele também aceitam um mapa de headers estáticos, então uma chave com escopo enviada como header Authorization Bearer também funciona, mas o OpenClaw ignora headers Authorization estáticos numa entrada definida como auth oauth, então use um ou outro.
Posso mostrar ao meu agente só algumas das ferramentas de e-mail?
Sim. Adicione --include com uma lista de nomes de ferramentas separados por vírgula, ou um padrão como 'email_*', ao rodar openclaw mcp add, ou defina toolFilter no servidor na configuração. Isso restringe o que o agente vê. O que ele pode de fato fazer continua definido pelos escopos que você aprovou na tela de consentimento.
Quais caixas de correio o OpenClaw alcança assim?
Outlook.com e Microsoft 365 com Entrar com a Microsoft, em que uma conta de trabalho pode precisar que um administrador de TI aprove o app uma vez; Gmail, iCloud, Fastmail, Yahoo, Zoho e Yandex com uma senha específica de app; e qualquer outra caixa de correio que fale IMAP e SMTP nas portas padrão. Seu agente chama inbox_list primeiro para descobrir cada caixa conectada e o id dela, então não há UUIDs para colar em lugar nenhum.
O OpenClaw pode enviar e-mails sem eu ver?
Só se você deixar. O envio depende do escopo send:email, então um token sem esse escopo não consegue enviar nada. Além disso, o dono de uma caixa de entrada pode exigir aprovação humana no painel, que segura todo envio, resposta, encaminhamento, envio de rascunho e envio agendado até que uma pessoa libere. Para um agente que roda sem supervisão em vários canais de chat, vale usar os dois.
Meus e-mails ficam armazenados nos seus servidores?
Não. Cada mensagem é buscada ao vivo no seu provedor para a solicitação que a pediu e entregue direto ao seu agente. Só o token OAuth ou a senha de app criptografados ficam guardados, para que as próximas chamadas possam autenticar. Excluir a caixa de entrada no painel, ou revogar o acesso no seu provedor, encerra a conexão na hora.
Dê ao seu agente OpenClaw uma caixa de entrada real
Um servidor, um login. Uma caixa de entrada grátis para sempre, sem cartão.