Resend Email

oficial

Envie 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

npm version

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 ambiente MCP_PORT)
  • --host: host para proteção contra DNS rebinding ao usar --http (padrão: 127.0.0.1 ou MCP_HOST). Defina como 0.0.0.0 para desativar a validação Host atrás de um proxy/balanceador de carga.
  • --allowed-hosts: lista de permissões Host separada por vírgulas ao usar --http (ou MCP_ALLOWED_HOSTS)
  • --allowed-file-dirs: diretórios separados por vírgulas dos quais anexos de arquivos locais e importações CSV podem ser lidos (ou MCP_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ões Host separada 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) e create-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-dirs para permitir diretórios específicos. Em stdio, defina --allowed-file-dirs para 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

  1. Clone este projeto e compile:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. Para usar a compilação local, substitua o comando npx pelo 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:

  1. Execute o observador de TypeScript para recompilar automaticamente ao salvar:

    pnpm tsc --watch
    
  2. Em um diretório separado, crie um .mcp.json apontando 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"
          }
        }
      }
    }
    
  3. 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

  1. Defina sua chave de API:

    export RESEND_API_KEY=re_your_key_here
    
  2. Inicie o inspetor:

    pnpm inspector
    
  3. No navegador (interface do inspetor):

    • Escolha stdio (inicie um processo).
    • Comando: node
    • Args: dist/index.js (ou o caminho completo para dist/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

  1. Inicie o servidor HTTP em um terminal:

    node dist/index.js --http --port 3000
    
  2. Inicie o inspetor em outro terminal:

    pnpm inspector
    
  3. 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_here e ative a opção.
    • Clique em Connect e use "List tools" para verificar se o servidor está funcionando.