Conecte sua caixa de entrada ao Cursor
com quatro linhas de mcp.json
Dê ao editor uma caixa de correio real. Responda a um relatório de bug a partir do arquivo que causou o problema, envie a correção a um cliente ou limpe uma caixa de entrada sem trocar de janela.
O Cursor abre com o MCPEmails já preenchido. Confirme e, na página do navegador que vem em seguida, crie sua conta e escolha sua caixa de entrada.
O único valor de que você precisa
Adicione uma entrada em mcpServers no ~/.cursor/mcp.json com a url https://mcpemails.com/api/mcp. O Cursor então pede que você faça login por OAuth, e nenhuma chave de API entra na história.
| 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 Cursor se conecta: OAuth, sem chave de API
O Cursor 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.
Exemplo: Gmail no Cursor
Conecte o Gmail no painel do MCPEmails com uma senha de app do Google, adicione a entrada mcpemails mostrada abaixo ao ~/.cursor/mcp.json e faça login quando o Cursor pedir. Depois peça ao agente do Cursor algo como "encontre o relatório de bug que a Anna mandou para o meu Gmail ontem e escreva um rascunho de resposta dizendo que a correção sai hoje". Ele pesquisa seu Gmail, lê a conversa e salva a resposta como rascunho no Gmail para você conferir antes que ela vá para qualquer lugar.
Como conectar o Cursor à 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 mcp.json
Edite ~/.cursor/mcp.json para todos os projetos, ou .cursor/mcp.json dentro de um projeto.
Adicione o servidor
Adicione a entrada abaixo em mcpServers. O campo que o Cursor espera aqui é url.
Autorize
O Cursor pede que você faça login por OAuth. Autorize com o MCPEmails e aprove os escopos que você quer que o editor tenha.
{
"mcpServers": {
"mcpemails": {
"url": "https://mcpemails.com/api/mcp"
}
}
}Documentação oficial do Cursor sobre servidores MCP remotos: https://cursor.com/docs/mcp
Prefere um passo a passo completo? E-mail para agentes de IA no Cursor, Cline e VS Code
Na dúvida sobre qual caixa de correio conectar primeiro? Veja a tabela de compatibilidade de provedores
Onde as pessoas costumam tropeçar no Cursor
Configuração do projeto e configuração global são arquivos diferentes, e os dois existem
Um servidor em ~/.cursor/mcp.json acompanha você em todos os projetos; um em .cursor/mcp.json pertence só àquele repositório. E-mail costuma ser uma coisa sua, não do repositório, então o arquivo global é o lugar melhor, e ele mantém a entrada fora de um repositório que outras pessoas clonam.
Um mcp.json de projeto é um arquivo que você pode commitar sem querer
A entrada em si não guarda segredo nenhum, só uma URL pública, e os tokens OAuth são armazenados pelo Cursor, não escritos ali. Isso muda no momento em que alguém troca a entrada OAuth por uma chave de API bearer escrita direto no arquivo. Se você for pelo caminho da chave, mantenha-a fora de arquivos commitados e revogue qualquer chave que já tenha ido para um push: as chaves são revogáveis no painel, em Chaves de API, com um clique.
Dê ao editor menos do que você daria a um app de e-mail
Um agente de código com delete:email é um poder estranho para entregar a uma ferramenta cuja função principal é refatorar. Os escopos de leitura, pesquisa e rascunho cobrem quase todo fluxo de trabalho de editor. Você sempre pode emitir uma segunda conexão, mais ampla, para o assistente em que você realmente faz a triagem dos e-mails.
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.
Cursor e e-mail: perguntas e respostas
Como conecto o e-mail ao Cursor?
Adicione uma entrada em mcpServers no ~/.cursor/mcp.json com a url https://mcpemails.com/api/mcp e conclua o login OAuth que o Cursor pedir. O Cursor passa a ter ferramentas para ler, pesquisar, enviar, responder, encaminhar, organizar e agendar e-mails em todas as caixas de correio que você conectou.
Preciso de uma chave de API para o Cursor?
Não. O Cursor executa o fluxo OAuth no navegador com este servidor, registrando-se dinamicamente e autorizando com PKCE, então o arquivo de configuração não guarda nada secreto. Uma chave de API bearer continua sendo uma opção para configurações automatizadas ou headless.
Por que o campo se chama url aqui e serverUrl no Windsurf?
Porque os dois clientes escolheram schemas de configuração diferentes para a mesma ideia. O Cursor lê url em mcpServers, o Windsurf lê serverUrl, o VS Code quer type e url em servers, e o Gemini CLI quer httpUrl. O endpoint é idêntico nos quatro; só muda o nome da chave, e copiar um trecho de um cliente para outro é o motivo mais comum de uma configuração simplesmente não fazer nada.
Quais caixas de correio o Cursor 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 Cursor 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 Cursor uma caixa de entrada real
Quatro linhas de configuração, um login. Uma caixa de entrada grátis para sempre, sem cartão.