Resend Email
oficialEnvie e-mails diretamente do seu editor usando a API do Resend.
O que você pode fazer com Resend Email MCP?
- Enviar e agendar e-mails — Peça ao seu assistente para enviar e-mails em HTML ou texto simples com CC/BCC, responder para, anexos, tags e agendamento.
- Gerenciar contatos e segmentos — Crie, atualize e remova contatos, gerencie associações a segmentos e inscrições em tópicos e execute importações de CSV.
- Executar campanhas de transmissão — Crie, agende, envie ou cancele transmissões e, em seguida, analise os destinatários por tipo de evento e links clicados.
- Gerenciar e-mails recebidos e caixas de entrada — Liste e leia e-mails recebidos, baixe anexos e gerencie conversas, marcadores e rascunhos da caixa de entrada.
- Administrar domínios e supressões — Crie, verifique e configure domínios de remetente e adicione ou remova entradas da lista de supressão.
- Inspecionar registros e uso — Analise os registros de solicitações da API com os corpos completos das solicitações e respostas e confira o uso e a cota da conta.
Servidor MCP hospedado
npx add-mcp 'https://mcp.resend.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Resend MCP Server
Conecte seu agente de IA à plataforma Resend. Envie e receba e-mails, gerencie contatos, campanhas, domínios e muito mais, diretamente de qualquer cliente MCP, como Claude, Cursor ou Claude Code.
Oferecemos um servidor MCP remoto hospedado pela Resend e um servidor MCP local (este pacote).
Servidor MCP remoto
A Resend hospeda o servidor MCP em:
https://mcp.resend.com/mcp
Conecte qualquer cliente MCP compatível com servidores remotos (Streamable HTTP). Não é necessário instalar nada nem executar um processo local, o que torna essa a melhor opção para clientes baseados na web, como Claude, e plataformas de agentes hospedadas.
Ao se conectar, seu cliente abre uma janela do navegador para você entrar na Resend e aprovar o acesso usando OAuth.
Claude Code
claude mcp add --transport http resend https://mcp.resend.com/mcp
Em seguida, execute /mcp no Claude Code e selecione resend para concluir o login OAuth.
Claude
No Claude (web ou desktop), abra Settings > Connectors > Add custom connector e informe:
https://mcp.resend.com/mcp
Cursor
Abra a paleta de comandos e escolha "Cursor Settings" > "MCP" > "Add new global MCP server".
{
"mcpServers": {
"resend": {
"url": "https://mcp.resend.com/mcp"
}
}
}
Codex
codex mcp add resend --url https://mcp.resend.com/mcp
Copilot
Para usar o GitHub Copilot no VS Code, adicione o seguinte ao seu settings.json:
{
"mcp": {
"servers": {
"resend": {
"type": "http",
"url": "https://mcp.resend.com/mcp"
}
}
}
}
Windsurf
{
"mcpServers": {
"resend": {
"serverUrl": "https://mcp.resend.com/mcp"
}
}
}
Warp
Nas configurações do Warp, acesse Agents > MCP servers e clique em +Add para adicionar um novo servidor.
{
"resend": {
"serverUrl": "https://mcp.resend.com/mcp"
}
}
Autenticação com uma chave de API
Se o cliente for executado em um ambiente onde não é possível fazer login pelo navegador (um servidor, CI ou agente sem interface), passe uma chave de API da Resend como token Bearer em vez de usar OAuth.
Claude Code:
claude mcp add --transport http resend https://mcp.resend.com/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Configuração JSON (Cursor, Windsurf e outros): adicione um cabeçalho Authorization:
{
"mcpServers": {
"resend": {
"url": "https://mcp.resend.com/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
Servidor MCP local
O servidor hospedado executa o mesmo código de código aberto disponível no NPM como resend-mcp. Se preferir executar o servidor por conta própria, você pode integrá-lo a qualquer cliente MCP compatível usando npx. Você precisará:
O servidor local oferece suporte a dois modos de transporte: stdio (padrão) e HTTP.
Escolha abaixo o modo e o cliente de sua preferência para começar. Lembre-se de substituir re_xxxxxxxxx pela sua chave de API.
Transporte Stdio (padrão)
Configuração rápida
Instale para todos os agentes e editores detectados/selecionados:
npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_xxxxxxxxx"
Claude Code
claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- npx -y resend-mcp
Codex
codex mcp add resend \
--env RESEND_API_KEY=re_xxxxxxxxx \
-- npx -y resend-mcp
Cursor
Abra a paleta de comandos e escolha "Cursor Settings" > "MCP" > "Add new global MCP server".
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Claude Desktop
Abra as configurações do Claude Desktop > guia "Developer" > "Edit Config".
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Copilot
Para usar o GitHub Copilot no VS Code, adicione o seguinte ao seu settings.json:
{
"mcp": {
"servers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
}
Gemini CLI
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
OpenCode
Adicione ao seu arquivo de configuração opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"resend": {
"type": "local",
"command": ["npx", "-y", "resend-mcp"],
"enabled": true,
"environment": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Windsurf
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Devin
No Devin, abra Settings > Connections > MCP Servers e clique em Add a custom MCP. Consulte o guia do Devin para ver as instruções completas, passo a passo.
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx",
"SENDER_EMAIL_ADDRESS": "onboarding@resend.dev"
}
}
}
}
Transporte HTTP
Execute o servidor por HTTP para integrações remotas ou baseadas na web, por exemplo, por trás do seu próprio túnel ou proxy reverso, em vez de usar o servidor MCP remoto hospedado da Resend. No modo HTTP, cada cliente se autentica passando sua chave de API da Resend como token Bearer no cabeçalho Authorization.
Inicie o servidor:
npx -y resend-mcp --http --port 3000
O servidor escutará em http://127.0.0.1:3000 e disponibilizará o endpoint MCP em /mcp usando Streamable HTTP.
Claude Code
claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Cursor
Abra a paleta de comandos e escolha "Cursor Settings" > "MCP" > "Add new global MCP server".
{
"mcpServers": {
"resend": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
Você também pode definir a porta pela variável de ambiente MCP_PORT:
MCP_PORT=3000 npx -y resend-mcp --http
Usar como biblioteca
O transporte HTTP também é exportado para que possa ser incorporado a outro serviço, em vez de ser executado pela CLI. Cada cliente que se conecta se autentica com sua própria chave de API da Resend, passada como token Bearer.
import { runHttp } from 'resend-mcp/http';
// Options are optional — pass `senderEmailAddress` / `replierEmailAddresses`
// to set defaults. Binds the port and returns the Node http.Server, exposing
// the MCP endpoint at POST/GET/DELETE /mcp and a GET /health check.
const server = await runHttp({}, 3000);
Por padrão, o servidor aplica a validação Host somente para localhost (proteção contra DNS rebinding). Ao implantar atrás de um proxy reverso ou balanceador de carga, onde o servidor é protegido pela chave de API Bearer por solicitação, defina host como 0.0.0.0 para que o Host encaminhado pelo proxy e as verificações de integridade do balanceador de carga não sejam rejeitados com 403 Invalid Host:
const server = await runHttp({}, 3000, { host: '0.0.0.0' });
// or pin specific hostnames instead of disabling validation:
const server = await runHttp({}, 3000, { allowedHosts: ['mcp.example.com'] });
Pela CLI, isso corresponde a --host / --allowed-hosts (ou MCP_HOST / MCP_ALLOWED_HOSTS).
Opções
Você pode passar argumentos adicionais para configurar o servidor local:
--key: sua chave de API da Resend (somente no modo stdio, pois o modo HTTP usa o token Bearer do cliente)--sender: endereço de e-mail padrão do remetente, de um domínio verificado--reply-to: endereço de e-mail padrão para respostas (pode ser especificado várias vezes)--http: usar transporte HTTP em vez de stdio (padrão: stdio)--port: porta HTTP ao usar--http(padrão: 3000 ou variável de ambienteMCP_PORT)--host: host para proteção contra DNS rebinding ao usar--http(padrão:127.0.0.1ouMCP_HOST). Defina como0.0.0.0para desativar a validaçãoHostatrás de um proxy/balanceador de carga.--allowed-hosts: lista de permissõesHostseparada por vírgulas ao usar--http(ouMCP_ALLOWED_HOSTS)--allowed-file-dirs: diretórios separados por vírgulas dos quais anexos de arquivos locais e importações CSV podem ser lidos (ouMCP_ALLOWED_FILE_DIRS). Sem restrições em stdio quando não definido; sempre desativado em--http, a menos que seja definido.
Variáveis de ambiente:
RESEND_API_KEY: sua chave de API da Resend (obrigatória para stdio, opcional para HTTP, pois os clientes a passam pelo token Bearer)SENDER_EMAIL_ADDRESS: endereço de e-mail padrão do remetente, de um domínio verificado (opcional)REPLY_TO_EMAIL_ADDRESSES: endereços de e-mail para respostas, separados por vírgulas (opcional)MCP_PORT: porta HTTP ao usar--http(opcional)MCP_HOST: host para proteção contra DNS rebinding ao usar--http(opcional)MCP_ALLOWED_HOSTS: lista de permissõesHostseparada por vírgulas ao usar--http(opcional)MCP_ALLOWED_FILE_DIRS: diretórios separados por vírgulas dos quais arquivos locais podem ser lidos (opcional)
[!NOTE] Se você não informar um endereço de e-mail do remetente, o servidor MCP solicitará que você informe um sempre que chamar a ferramenta.
[!WARNING]
send-email(attachments[].filePath) ecreate-contact-import(filePath) leem arquivos locais. Em--http, isso fica desativado por padrão para que clientes remotos não possam ler o disco do servidor; use--allowed-file-dirspara permitir diretórios específicos. Em stdio, defina--allowed-file-dirspara impedir que um agente manipulado por injeção de prompt anexe arquivos de pastas fora das que você escolher.
Ferramentas do servidor MCP
O servidor MCP da Resend oferece ao seu agente de IA acesso nativo a toda a plataforma Resend por meio de uma única integração. Você pode gerenciar todos os aspectos da sua infraestrutura de e-mail usando linguagem natural.
- E-mails: envie, liste, consulte, cancele, atualize, compartilhe e envie e-mails em lote. Recupere métricas de entrega e engajamento. Oferece suporte a HTML, texto simples, anexos (arquivo local, URL ou base64), CC/BCC, responder para, agendamento, tags, cabeçalhos personalizados, envio baseado em tópicos e chaves de idempotência.
- E-mails recebidos: liste e leia e-mails recebidos. Liste e baixe anexos de e-mails recebidos.
- Caixas de entrada: crie, liste, consulte, atualize e remova caixas de entrada. Leia e atualize as configurações do agente da caixa de entrada. Liste, pesquise, consulte, atualize e remova conversas, além de adicionar, definir ou remover seus rótulos. Liste e consulte os e-mails de uma conversa e responda ou encaminhe-os com anexos e cabeçalhos personalizados. Crie, liste, atualize e remova rótulos. Crie, liste, consulte, atualize, remova e envie rascunhos, com anexos de conteúdo base64 ou de uma URL. Envie um novo e-mail de uma caixa de entrada para iniciar uma conversa. Oferece suporte a chaves de idempotência ao responder, encaminhar, criar rascunhos, enviar rascunhos e enviar novos e-mails.
- Modelos: crie, liste, consulte, atualize, publique, duplique e remova modelos de e-mail. Oferece suporte à composição do conteúdo dos modelos e a espaços reservados
{{{VARIABLE}}}. - Contatos: crie, liste, consulte, atualize e remova contatos. Gerencie associações a segmentos, inscrições em tópicos e importações de contatos por CSV. Oferece suporte a propriedades personalizadas de contatos.
- Campanhas: crie, envie, cancele, duplique, liste, consulte, atualize e remova campanhas. Liste os links clicados de uma campanha e seus destinatários por tipo de evento (enviado, entregue, aberto, clicado, devolvido, reclamação, cancelamento de inscrição, suprimido). Oferece suporte a agendamento, espaços reservados de personalização e texto de pré-visualização.
- Automações: crie, liste, consulte, atualize, duplique e remova automações. Consulte as execuções de uma automação.
- Eventos: envie eventos para acionar automações para um contato. Crie, atualize e remova definições de eventos.
- Domínios: crie, liste, consulte, atualize, remova e verifique domínios de remetentes. Configure recursos de rastreamento, TLS e envio/recebimento. Crie e verifique reivindicações de domínio.
- Segmentos: crie, liste, consulte, atualize e remova segmentos de público.
- Supressões: liste, consulte, adicione e remova entradas da lista de supressão, individualmente ou em lote. Devoluções permanentes e reclamações de spam são suprimidas automaticamente; adicione endereços manualmente para atender a solicitações de não contato.
- Tópicos: crie, liste, consulte, atualize e remova tópicos de inscrição.
- Propriedades de contato: crie, liste, consulte, atualize e remova atributos personalizados de contatos.
- Chaves de API: crie, liste, atualize e remova chaves de API.
- Webhooks: crie, liste, consulte, atualize e remova webhooks para notificações de eventos e inspecione o histórico de entregas — os eventos enviados a um webhook, o conteúdo de um evento e as tentativas de entrega. Reenvie um evento para enfileirar outra entrega e alterne o segredo de assinatura de um webhook.
- Logs: liste e inspecione logs de solicitações à API, incluindo os corpos completos das solicitações e respostas.
- Uso: recupere informações de uso e cotas no nível da conta: e-mails, contatos, segmentos, campanhas, créditos de IA, execuções de automações, domínios e limite de taxa da API.
- Editor: conecte-se ao editor visual do painel da Resend (ou desconecte-se dele) e leia o conteúdo de um rascunho enquanto colabora em campanhas e modelos.
Desenvolvimento local
- Clone este projeto e compile:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
- Para usar a compilação local, substitua o comando
npxpelo caminho da sua compilação local:
Claude Code (stdio):
claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- node ABSOLUTE_PATH_TO_PROJECT/dist/index.js
Claude Code (HTTP):
claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Cursor / Claude Desktop (stdio):
{
"mcpServers": {
"resend": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Cursor (HTTP):
{
"mcpServers": {
"resend": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
Testes ao vivo com um cliente MCP
Durante o desenvolvimento, você pode testar alterações em uma sessão real de um cliente MCP enquanto edita o código em outra.
A ideia: execute tsc --watch para recompilar continuamente dist/ e configure um cliente MCP separado para usar o dist/index.js compilado, a partir de outro diretório. Para aplicar as alterações no código, reinicie a sessão do cliente MCP (os servidores MCP são processos stdio de longa duração que não recarregam automaticamente).
Exemplo com Claude Code:
-
Execute o observador de TypeScript para recompilar automaticamente ao salvar:
pnpm tsc --watch -
Em um diretório separado, crie um
.mcp.jsonapontando para a saída da compilação:mkdir -p /tmp/mcp-test// /tmp/mcp-test/.mcp.json { "mcpServers": { "resend-dev": { "command": "node", "args": ["/absolute/path/to/resend-mcp/dist/index.js"], "env": { "RESEND_API_KEY": "re_xxxxxxxxx" } } } } -
Inicie o Claude Code nesse diretório e use as ferramentas MCP. Depois de fazer alterações no código, inicie uma nova sessão do Claude Code para usar a nova compilação.
O mesmo princípio se aplica a qualquer cliente MCP — mantenha o ambiente de teste separado do ambiente de desenvolvimento, use um caminho absoluto para dist/index.js e reconecte o servidor MCP após recompilar.
Testes com o MCP Inspector
Observação: compile o projeto primeiro (consulte a seção Desenvolvimento local acima).
Usando o transporte Stdio
-
Defina sua chave de API:
export RESEND_API_KEY=re_your_key_here -
Inicie o inspetor:
pnpm inspector -
No navegador (interface do inspetor):
- Escolha stdio (inicie um processo).
- Comando:
node - Args:
dist/index.js(ou o caminho completo paradist/index.js) - Env:
RESEND_API_KEY=re_your_key_here(ou deixe em branco se você já a exportou no mesmo terminal). - Clique em Connect e use "List tools" para verificar se o servidor está funcionando.
Usando transporte HTTP
-
Inicie o servidor HTTP em um terminal:
node dist/index.js --http --port 3000 -
Inicie o inspetor em outro terminal:
pnpm inspector -
No navegador (interface do inspetor):
- Escolha Streamable HTTP (conecte-se à URL).
- URL:
http://127.0.0.1:3000/mcp - Adicione um cabeçalho personalizado:
Authorization: Bearer re_your_key_heree ative a opção. - Clique em Connect e use "List tools" para verificar se o servidor está funcionando.