Guide

Dê ao seu agente de IA um endereço de e-mail

Agentes de IA programadores escrevem código, depuram testes e refatoram arquivos — mas não conseguem enviar uma notificação de deploy, ler um e-mail de confirmação ou verificar um convite de calendário. O Nylas CLI dá ao Claude Code, Cursor, OpenAI Codex CLI e OpenClaw acesso a uma conta de e-mail real em 6 provedores — Gmail, Outlook, Exchange, Yahoo, iCloud e IMAP. Uma autenticação, 16 ferramentas MCP, configuração em menos de 2 minutos por agente.

Written by Caleb Geene Director, Site Reliability Engineering

Reviewed by Hazik

Verified — CLI 3.1.1 · Gmail, Outlook · last tested April 11, 2026

Por que dar um endereço de e-mail a um agente de IA?

Agentes de IA que conseguem ler e enviar e-mail se tornam capazes de tarefas que a geração de código pura não resolve — enviar notificações de deploy, extrair códigos OTP de fluxos de cadastro e agendar reuniões após revisões de código. O e-mail transforma um agente restrito a código em um que interage com pessoas e serviços fora do repositório.

Workflows de agente-para-e-mail estão se tornando um padrão central entre desenvolvedores porque agentes precisam de uma forma durável de trocar mensagens com pessoas, serviços e outros agentes. A maioria das soluções prende você a um único provedor: servidores MCP do Gmail só funcionam com o Google, e o Microsoft Graph só funciona com o Outlook. O Nylas CLI conecta todos os 6 principais provedores de e-mail em um único fluxo de autenticação e funciona com qualquer agente de código compatível com MCP.

Passo 1: Cadastre-se, conecte uma conta e configure a CLI

Antes de conectar qualquer agente, você precisa de uma conta Nylas com pelo menos um grant de e-mail e o Nylas CLI autenticado com sua chave de API. Todo o fluxo de pré-requisitos leva cerca de 2 minutos e só precisa ser feito uma vez — cada agente conectado depois reutiliza as mesmas credenciais e o mesmo grant.

1. Cadastre-se no Nylas e crie uma chave de API

Acesse dashboard-v3.nylas.com, crie uma conta gratuita e gere uma chave de API em Settings. O plano gratuito do Nylas inclui até 5 contas conectadas.

2. Conecte pelo menos uma conta de e-mail em Grants

No painel do Nylas, vá para Grants e conecte uma conta do Gmail, Outlook, Exchange, Yahoo, iCloud ou IMAP. Este é o endereço de e-mail que seu agente de IA vai usar. O Nylas cuida do fluxo OAuth para Google e Microsoft, então você não precisa registrar seu próprio app OAuth.

3. Instale o Nylas CLI e configure sua chave de API

O Nylas CLI é um binário único sem dependências de runtime. No macOS e Linux, o Homebrew é o método de instalação mais rápido. Após instalar, execute nylas auth config --api-key para armazenar sua chave de API localmente, depois verifique com nylas auth whoami.

# Instalar (macOS / Linux)
brew install nylas/nylas-cli/nylas

# Configurar sua chave de API
nylas auth config --api-key YOUR_NYLAS_API_KEY

# Verificar a conexão
nylas auth whoami

No Windows ou para instalação via shell script e Go, veja o guia de primeiros passos.

Substitua YOUR_NYLAS_API_KEY pela chave do painel Nylas. De acordo com a documentação MCP do Nylas, isso dá ao seu agente acesso a 16 ferramentas de e-mail, calendário e contatos em todos os 6 provedores.

Passo 2a: Dê ao Claude Code um endereço de e-mail

O Claude Code suporta MCP nativamente, então conectá-lo a uma conta de e-mail real requer um único comando. O Nylas CLI grava a configuração do servidor MCP e pré-aprova todas as 16 ferramentas no arquivo de configuração do Claude Code, eliminando os prompts de permissão por ferramenta que de outra forma interromperiam cada ação de e-mail.

O comando nylas mcp install aponta diretamente para os arquivos de configuração do Claude Code. Ele adiciona uma entrada de servidor em ~/.claude.json e uma permissão wildcard para mcp__nylas__* em ~/.claude/settings.json.

# Instalar MCP para Claude Code
nylas mcp install --assistant claude-code

Após executar este comando, reinicie o Claude Code para que ele reconheça o novo servidor MCP. Todas as 16 ferramentas Nylas são pré-aprovadas sem prompts interativos. Experimente estas solicitações em linguagem natural:

  • "Leia meus últimos 5 e-mails"
  • "Envie um e-mail para alice@example.com sobre o deploy"
  • "Verifique meu calendário para amanhã"

Para o guia completo sobre MCP -- ferramentas disponíveis, endpoints regionais, tratamento de fuso horário -- veja o guia AI Agent Email Access via MCP.

Passo 2b: Dê ao Cursor um endereço de e-mail

O Cursor suporta MCP nativamente, e o Nylas CLI o configura com um único comando. O Cursor oferece dois métodos de conexão: um servidor STDIO local através da CLI, ou um endpoint HTTP hospedado que dispensa a CLI. Ambos os métodos expõem as mesmas 16 ferramentas ao modo agente do Cursor.

O método local executa nylas mcp install --assistant cursor, que grava uma entrada de servidor em ~/.cursor/mcp.json. O processo da CLI roda como servidor STDIO local e gerencia todas as chamadas de API para o Nylas.

# Instalar MCP para Cursor
nylas mcp install --assistant cursor

Após executar a instalação, reinicie o Cursor, abra Settings e verifique em Tools & MCP se há um ponto verde ao lado de "nylas".

Alternativa: servidor MCP hospedado (sem instalar a CLI). O Cursor também suporta servidores MCP streamable HTTP. Este método se conecta diretamente ao endpoint MCP do Nylas em mcp.us.nylas.com, eliminando a necessidade de um processo CLI local. Adicione isso ao ~/.cursor/mcp.json:

{
  "mcpServers": {
    "nylas": {
      "type": "streamable-http",
      "url": "https://mcp.us.nylas.com",
      "headers": {
        "Authorization": "Bearer YOUR_NYLAS_API_KEY"
      }
    }
  }
}

Substitua YOUR_NYLAS_API_KEY pela sua chave de API do painel Nylas. Isso dispensa completamente o proxy CLI local. A documentação MCP do Nylas cobre ambos os métodos.

Passo 2c: Dê ao OpenAI Codex CLI um endereço de e-mail

O OpenAI Codex CLI suporta servidores MCP nativamente e oferece três métodos de conexão: STDIO local via Nylas CLI, um endpoint HTTP hospedado, ou comandos shell diretos sem MCP. De acordo com a documentação MCP do OpenAI Codex, o Codex inicia servidores MCP automaticamente ao abrir uma sessão, sem necessidade de processo manual.

Opção A: MCP local via Nylas CLI

O comando codex mcp add registra o Nylas como servidor STDIO local. O Codex armazena isso em ~/.codex/config.toml e inicia o processo do servidor no início de cada sessão.

# Adicionar Nylas como servidor MCP (STDIO)
codex mcp add nylas -- nylas mcp serve

Isso adiciona uma entrada [mcp_servers.nylas] em ~/.codex/config.toml. A configuração resultante fica assim:

# ~/.codex/config.toml
[mcp_servers.nylas]
command = "nylas"
args = ["mcp", "serve"]

Opção B: Servidor MCP hospedado (sem instalar a CLI)

O método hospedado conecta o Codex diretamente ao endpoint MCP do Nylas via HTTP, dispensando completamente o processo CLI local. O Codex lê o bearer token de uma variável de ambiente, então a chave de API nunca aparece no arquivo de configuração. Adicione a entrada do servidor em ~/.codex/config.toml e defina a variável de ambiente NYLAS_API_KEY no perfil do seu shell.

# ~/.codex/config.toml
[mcp_servers.nylas]
url = "https://mcp.us.nylas.com"
bearer_token_env_var = "NYLAS_API_KEY"
# Definir a variável de ambiente
export NYLAS_API_KEY="your-api-key-here"

Opção C: Comandos shell (sem MCP)

O Codex também pode executar comandos do Nylas CLI diretamente no seu shell sandbox sem MCP. Cada comando roda no sandbox do Codex, que exige aprovação do usuário antes da execução — adicionando uma etapa de confirmação manual para cada ação. Os comandos da CLI retornam texto simples por padrão ou JSON estruturado com a flag --json, que o Codex pode interpretar para raciocínio subsequente.

# Ler e-mails recentes
nylas email list --limit 10

# Buscar e-mails específicos
nylas email search "deploy notification"

# Enviar um e-mail
nylas email send --to alice@example.com --subject "Deploy complete" --body "v2.4.1 is live."

# Saída JSON para parsing estruturado
nylas email list --limit 5 --json

Para construir definições de ferramentas estruturadas em torno de comandos shell, veja Build an LLM Agent with Email Tools.

Passo 2d: Dê ao OpenClaw um endereço de e-mail

O OpenClaw usa um sistema de plugins ao invés de MCP, então a configuração é diferente dos outros 4 agentes. O plugin Nylas dá ao OpenClaw ferramentas nativas de e-mail, calendário e contatos com schemas tipados e suporte multi-conta. A instalação leva 6 comandos: instalar o plugin, autorizá-lo, configurar a chave de API, reiniciar o gateway e verificar.

O sistema de plugins exige configuração explícita de confiança. Após instalar o pacote do plugin, você deve adicionar "nylas" tanto em plugins.allow quanto em tools.alsoAllow para que o OpenClaw exponha as ferramentas às sessões do agente. O reinício do gateway garante que a nova configuração do plugin seja carregada.

# Instalar o plugin Nylas
openclaw plugins install @nylas/openclaw-nylas-plugin

# Autorizar o plugin e expor suas ferramentas às sessões do agente
openclaw config set 'plugins.allow' '["nylas"]'
openclaw config set 'tools.alsoAllow' '["nylas"]'

# Configurar sua chave de API
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# Reiniciar o gateway para recarregar a configuração do plugin
openclaw gateway restart

# Verificar se o plugin pode ver suas contas conectadas
openclaw plugins list
openclaw run "List my connected email accounts" --plugin nylas

Após instalado, o OpenClaw pode enviar e-mails, ler threads, gerenciar eventos de calendário e buscar contatos por linguagem natural. O plugin descobre automaticamente todas as contas de e-mail conectadas no painel Nylas — sem necessidade de configuração por conta.

Detalhes completos de configuração estão no guia Install the OpenClaw Nylas Plugin . Novo no OpenClaw? Comece pelo guia de configuração do OpenClaw CLI.

Comparação: configuração de e-mail entre agentes de IA

Cinco agentes de IA podem se conectar ao e-mail através do Nylas, e cada um usa um arquivo de configuração e método de integração diferente. Quatro deles -- Claude Code, Cursor, Codex CLI e Windsurf -- conectam via MCP usando um servidor STDIO local ou um endpoint HTTP hospedado. O OpenClaw conecta através do seu próprio sistema de plugins. A tabela resume o comando de configuração e a localização do arquivo de config para cada agente.

Agente de IAIntegraçãoComando de configuraçãoArquivo de configuração
Claude CodeMCP (STDIO)nylas mcp install --assistant claude-code~/.claude.json
CursorMCP (STDIO ou HTTP)nylas mcp install --assistant cursor~/.cursor/mcp.json
OpenAI Codex CLIMCP (STDIO ou HTTP)codex mcp add nylas -- nylas mcp serve~/.codex/config.toml
WindsurfMCP (STDIO)nylas mcp install --assistant windsurfWindsurf config
OpenClawPluginopenclaw plugins install @nylas/openclaw-nylas-pluginOpenClaw plugin registry

Todos os cinco agentes recebem as mesmas 16 ferramentas de e-mail, calendário e contatos. Agentes MCP (Claude Code, Cursor, Codex, Windsurf) se conectam através do servidor MCP do Nylas. O OpenClaw se conecta através do seu sistema de plugins. Todos os métodos suportam os 6 provedores de e-mail: Gmail, Outlook, Exchange, Yahoo, iCloud e IMAP.

O que seu agente pode fazer com acesso a e-mail

Um agente de IA com acesso a e-mail pode lidar com 6 categorias de tarefas que de outra forma exigiriam alternar para um cliente de e-mail: enviar notificações, ler confirmações, extrair códigos OTP, agendar reuniões, pesquisar histórico de e-mails e redigir respostas. Todas as 16 ferramentas MCP funcionam com instruções em linguagem natural — sem flags ou sintaxe de comando.

  • Enviar uma notificação de deploy -- "Envie um e-mail ao time informando que a v2.4.1 está em produção"
  • Ler um e-mail de confirmação -- "Verifique minha caixa de entrada pela confirmação de cadastro da AWS"
  • Extrair um código OTP -- "Pegue o código de verificação de 6 dígitos do meu último e-mail" (veja Email as Identity for AI Agents)
  • Agendar uma reunião -- "Marque uma chamada de 30 minutos com alice@company.com na próxima terça às 14h"
  • Pesquisar histórico de e-mails -- "Encontre todos os e-mails sobre o contrato do Q4 e resuma as decisões principais"
  • Redigir uma resposta -- "Escreva uma resposta para a pergunta da Sarah sobre orçamento com os números atualizados"

Segurança e controle de acesso

Dar acesso a e-mail a um agente de IA exige proteções para evitar envios não intencionais e acesso não autorizado a dados. O Nylas CLI e o MCP aplicam um padrão de envio em 2 etapas: o agente cria um rascunho primeiro, depois uma etapa separada de confirmação o aprova antes que qualquer e-mail saia da conta. Esse padrão se aplica a todos os 5 agentes suportados e cobre 100% das ações de e-mail de saída.

  • Confirmação de envio obrigatória. As ferramentas MCP exigem uma etapa confirm_send_draft antes que qualquer e-mail seja realmente enviado. Seu agente cria um rascunho primeiro, depois você o aprova.
  • Armazenamento local de credenciais. O Nylas CLI armazena tokens OAuth na sua máquina. Eles não saem do seu sistema a menos que você execute um comando.
  • Execução em sandbox. O Codex CLI executa comandos shell em um sandbox com aprovação do usuário para cada ação.
  • Revogue a qualquer momento. Execute nylas auth logout para desconectar, ou nylas auth list para ver as contas conectadas.

Para registro de auditoria completo de cada ação que seus agentes de IA realizam com e-mail, veja o guia Audit AI Agent Activity.

Próximos passos

Com o acesso a e-mail configurado, os próximos passos naturais são estabelecer proteções para controlar o que o agente pode enviar, auditar a atividade do agente para conformidade e construir workflows personalizados de agente em Python ou TypeScript. Os guias listados aqui cobrem todo o ciclo de vida, desde o acesso inicial ao e-mail até uma infraestrutura de e-mail de agente pronta para produção.