Conecte sua caixa de entrada ao Gemini CLI
com uma entrada de configuração
Dê ao Gemini CLI uma caixa de correio real. Leia, pesquise, envie, responda, encaminhe, agende e organize e-mails pelo terminal, em todas as caixas de entrada que você conectou.
gemini mcp add --transport http mcpemails https://mcpemails.com/api/mcpO único valor de que você precisa
Adicione uma entrada em mcpServers no ~/.gemini/settings.json usando o campo httpUrl com https://mcpemails.com/api/mcp. Na primeira conexão, o CLI descobre os metadados OAuth e abre o fluxo no navegador sozinho. Ou rode gemini mcp add --transport http mcpemails https://mcpemails.com/api/mcp e depois /mcp auth mcpemails para fazer login.
| 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 Gemini CLI se conecta: OAuth, sem chave de API
O Gemini CLI executa o fluxo OAuth padrão do MCP com este servidor. 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. Nenhum client secret é transmitido, e o token carrega só os escopos que você aprova na nossa tela de consentimento. O token de acesso que ele recebe dura uma hora e se renova sozinho; ele aparece no painel, em Chaves de API, como OAuth: seguido do nome do cliente, e é ali que você revoga a conexão.
Como conectar o Gemini CLI à 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.
Abra o seu settings.json
Edite ~/.gemini/settings.json para todos os projetos, ou .gemini/settings.json dentro de um projeto.
Adicione o servidor
Adicione a entrada abaixo em mcpServers. O campo para um servidor Streamable HTTP aqui é httpUrl. Ou adicione numa linha só com gemini mcp add --transport http mcpemails https://mcpemails.com/api/mcp.
Conecte
Na primeira conexão, o CLI descobre o OAuth automaticamente pelos metadados do servidor e abre o fluxo no navegador. Aprove os escopos que você quer que o CLI tenha. Para fazer login a qualquer momento, rode /mcp auth mcpemails dentro do CLI.
{
"mcpServers": {
"mcpemails": {
"httpUrl": "https://mcpemails.com/api/mcp"
}
}
}Documentação oficial do Gemini CLI sobre servidores MCP remotos: https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md
Na dúvida sobre qual caixa de correio conectar primeiro? Veja a tabela de compatibilidade de provedores
Onde as pessoas costumam tropeçar no Gemini CLI
httpUrl é um campo diferente de url, e a diferença é o transporte
Nas configurações do Gemini CLI, httpUrl significa um servidor Streamable HTTP, que é o caso aqui. Outras chaves no mesmo objeto escolhem outros transportes. Um trecho copiado de um guia do Cursor, que usa url, não vai dar uma conexão Streamable HTTP funcionando aqui.
A descoberta é o que dispensa configuração, e ela começa num 401
O CLI não precisa saber onde autenticar. Uma chamada sem autenticação recebe um 401 cujo header WWW-Authenticate aponta para os metadados do nosso recurso protegido, que indicam o servidor de autorização, cujos metadados indicam os endpoints de registro, autorização e token. Essa cadeia é o motivo de não haver client ID para criar nem nada para colar além da URL.
Um CLI numa máquina compartilhada ou headless pede o caminho da chave
O fluxo no navegador precisa de um navegador. Num agente de build ou numa máquina compartilhada, a configuração certa é uma chave de API bearer limitada exatamente ao que aquela automação deve fazer, guardada no ambiente e não num arquivo de configuração commitado.
Contas gratuitas e do Google One agora usam o Antigravity CLI
Desde 18 de junho de 2026, o Google passou as contas do plano gratuito e do Google One do Gemini CLI para o Antigravity CLI. Lá, digite /mcp para abrir o gerenciador de MCP, ou adicione o servidor ao mcp_config.json usando o campo serverUrl.
Limites que vale a pena conhecer
- As solicitações têm limite de taxa por chave, em janelas por minuto, por hora e por dia dimensionadas para o seu plano. Uma resposta 429 traz Retry-After.
- 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.
Gemini CLI e e-mail: perguntas e respostas
Como conecto o e-mail ao Gemini CLI?
Adicione uma entrada em mcpServers no ~/.gemini/settings.json com httpUrl definido como https://mcpemails.com/api/mcp. Na primeira conexão, o CLI descobre o OAuth pelos metadados do servidor e abre o fluxo no navegador. Ele passa a ter ferramentas para ler, pesquisar, enviar, responder, encaminhar, organizar e agendar e-mails.
Uso url ou httpUrl?
httpUrl. Nas configurações do Gemini CLI, essa chave escolhe o transporte Streamable HTTP, que é o transporte que este servidor usa. Copiar uma entrada url de outro cliente é o motivo mais comum de o servidor aparecer na lista sem nenhuma ferramenta.
É a mesma coisa que o servidor MCP do Gmail que o Google publica?
Não. O Google publica um servidor MCP do Workspace que cobre o Gmail junto com seus outros serviços, e para o Gmail sozinho num fluxo só do Google esse é o caminho mais curto. O MCPEmails existe para quando nem todas as caixas de correio são do Google, e quando a mesma URL precisa funcionar também no Claude, no Cursor e no ChatGPT.
Quais caixas de correio o Gemini CLI 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. O cliente vê todas pela mesma conexã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 Gemini CLI pode enviar e-mails sem eu ver?
Só se você deixar. O envio depende do escopo send:email, então uma chave ou 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.
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 cliente. 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 Gemini CLI uma caixa de entrada real
Uma entrada de configuração, um login. Uma caixa de entrada grátis para sempre, sem cartão.