Resend Email

oficial

Envía correos electrónicos directamente desde tu editor usando la API de Resend.

¿Qué puedes hacer con Resend Email MCP?

  • Enviar y programar correos electrónicos — Pide a tu asistente que envíe correos electrónicos HTML o de texto sin formato con CC/CCO, dirección de respuesta, archivos adjuntos, etiquetas y programación.
  • Administrar contactos y segmentos — Crea, actualiza y elimina contactos, administra las pertenencias a segmentos y las suscripciones a temas, y ejecuta importaciones de CSV.
  • Ejecutar campañas de difusión — Crea, programa, envía o cancela campañas de difusión y luego revisa los destinatarios por tipo de evento y los enlaces en los que hicieron clic.
  • Gestionar correos entrantes y bandejas de entrada — Enumera y lee los correos recibidos, descarga archivos adjuntos y administra los hilos, las etiquetas y los borradores de la bandeja de entrada.
  • Administrar dominios y supresiones — Crea, verifica y configura dominios de remitente, y añade o elimina entradas de la lista de supresión.
  • Inspeccionar registros y uso — Revisa los registros de solicitudes de la API con los cuerpos completos de las solicitudes y las respuestas, y consulta el uso y la cuota de la cuenta.

Servidor MCP alojado

npx add-mcp 'https://mcp.resend.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP de Resend

npm version

Conecta tu agente de IA a la plataforma Resend. Envía y recibe correos electrónicos, administra contactos, campañas, dominios y mucho más, directamente desde cualquier cliente MCP como Claude, Cursor o Claude Code.

Ofrecemos tanto un servidor MCP remoto alojado por Resend como un servidor MCP local (este paquete).

Servidor MCP remoto

Resend aloja el servidor MCP en:

https://mcp.resend.com/mcp

Conecta cualquier cliente MCP compatible con servidores remotos (Streamable HTTP). No hay nada que instalar ni procesos locales que ejecutar, por lo que es la mejor opción para clientes web como Claude y plataformas de agentes alojadas.

Al conectarte, el cliente abre una ventana del navegador para iniciar sesión en Resend y aprobar el acceso mediante OAuth.

Claude Code

claude mcp add --transport http resend https://mcp.resend.com/mcp

Luego ejecuta /mcp en Claude Code y selecciona resend para completar el inicio de sesión con OAuth.

Claude

En Claude (web o escritorio), abre Settings > Connectors > Add custom connector e introduce:

https://mcp.resend.com/mcp

Cursor

Abre la paleta de comandos y selecciona "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 GitHub Copilot en VS Code, añade lo siguiente a tu settings.json:

{
  "mcp": {
    "servers": {
      "resend": {
        "type": "http",
        "url": "https://mcp.resend.com/mcp"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "resend": {
      "serverUrl": "https://mcp.resend.com/mcp"
    }
  }
}

Warp

En Settings de Warp, ve a Agents > MCP servers y haz clic en +Add para añadir un servidor nuevo.

{
  "resend": {
    "serverUrl": "https://mcp.resend.com/mcp"
  }
}

Autenticación con una clave de API

Si el cliente se ejecuta en un entorno donde no es posible iniciar sesión en un navegador (un servidor, CI o un agente sin interfaz), pasa una clave de API de Resend como token Bearer en lugar de usar OAuth.

Claude Code:

claude mcp add --transport http resend https://mcp.resend.com/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Configuración JSON (Cursor, Windsurf y otros): añade un encabezado Authorization:

{
  "mcpServers": {
    "resend": {
      "url": "https://mcp.resend.com/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Servidor MCP local

El servidor alojado ejecuta el mismo código de código abierto disponible en NPM como resend-mcp. Si prefieres ejecutar el servidor por tu cuenta, puedes integrarlo en cualquier cliente MCP compatible mediante npx. Necesitarás:

El servidor local admite dos modos de transporte: stdio (predeterminado) y HTTP.

Elige el modo y el cliente que prefieras a continuación para empezar. Recuerda sustituir re_xxxxxxxxx por tu clave de API real.

Transporte Stdio (predeterminado)

Configuración rápida

Instala para todos los agentes y editores detectados o seleccionados:

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

Abre la paleta de comandos y selecciona "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Abre la configuración de Claude Desktop > pestaña "Developer" > "Edit Config".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Copilot

Para usar GitHub Copilot en VS Code, añade lo siguiente a tu 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

Añade lo siguiente a tu configuración 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

En Devin, abre Settings > Connections > MCP Servers y haz clic en Add a custom MCP. Consulta la guía de Devin para ver todos los pasos.

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx",
        "SENDER_EMAIL_ADDRESS": "onboarding@resend.dev"
      }
    }
  }
}

Transporte HTTP

Ejecuta el servidor mediante HTTP para integraciones remotas o web, por ejemplo, detrás de tu propio túnel o proxy inverso, en lugar de usar el servidor MCP remoto alojado de Resend. En modo HTTP, cada cliente se autentica pasando su clave de API de Resend como token Bearer en el encabezado Authorization.

Inicia el servidor:

npx -y resend-mcp --http --port 3000

El servidor escuchará en http://127.0.0.1:3000 y expondrá el endpoint MCP en /mcp mediante Streamable HTTP.

Claude Code

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor

Abre la paleta de comandos y selecciona "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

También puedes establecer el puerto mediante la variable de entorno MCP_PORT:

MCP_PORT=3000 npx -y resend-mcp --http

Usar como biblioteca

El transporte HTTP también se exporta para que pueda integrarse en otro servicio en lugar de ejecutarse mediante la CLI. Cada cliente que se conecta se autentica con su propia clave de API de Resend, que pasa 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);

De forma predeterminada, el servidor aplica la validación Host exclusiva para localhost (protección contra el reenvío de DNS). Al implementarlo detrás de un proxy inverso o un balanceador de carga, donde el servidor está protegido por la clave de API Bearer de cada solicitud, establece host en 0.0.0.0 para que no se rechacen el Host reenviado por el proxy ni las comprobaciones de estado del balanceador de carga con 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'] });

Mediante la CLI, esto corresponde a --host / --allowed-hosts (o MCP_HOST / MCP_ALLOWED_HOSTS).

Opciones

Puedes pasar argumentos adicionales para configurar el servidor local:

  • --key: Tu clave de API de Resend (solo en modo stdio, ya que en modo HTTP se usa el token Bearer del cliente)
  • --sender: Dirección de correo electrónico del remitente predeterminada de un dominio verificado
  • --reply-to: Dirección de correo electrónico predeterminada para responder (se puede especificar varias veces)
  • --http: Usar transporte HTTP en lugar de stdio (predeterminado: stdio)
  • --port: Puerto HTTP al usar --http (predeterminado: 3000 o la variable de entorno MCP_PORT)
  • --host: Host para la protección contra el reenvío de DNS al usar --http (predeterminado: 127.0.0.1 o MCP_HOST). Establécelo en 0.0.0.0 para desactivar la validación Host detrás de un proxy o balanceador de carga.
  • --allowed-hosts: Lista de permitidos Host separada por comas al usar --http (o MCP_ALLOWED_HOSTS)
  • --allowed-file-dirs: Directorios separados por comas desde los que se pueden leer archivos adjuntos locales e importaciones CSV (o MCP_ALLOWED_FILE_DIRS). Sin restricciones en stdio si no se establece; siempre desactivado en --http salvo que se establezca.

Variables de entorno:

  • RESEND_API_KEY: Tu clave de API de Resend (obligatoria para stdio, opcional para HTTP, ya que los clientes la pasan mediante un token Bearer)
  • SENDER_EMAIL_ADDRESS: Dirección de correo electrónico del remitente predeterminada de un dominio verificado (opcional)
  • REPLY_TO_EMAIL_ADDRESSES: Direcciones de correo electrónico para responder, separadas por comas (opcional)
  • MCP_PORT: Puerto HTTP al usar --http (opcional)
  • MCP_HOST: Host para la protección contra el reenvío de DNS al usar --http (opcional)
  • MCP_ALLOWED_HOSTS: Lista de permitidos Host separada por comas al usar --http (opcional)
  • MCP_ALLOWED_FILE_DIRS: Directorios separados por comas desde los que se pueden leer archivos locales (opcional)

[!NOTE] Si no proporcionas una dirección de correo electrónico del remitente, el servidor MCP te pedirá que indiques una cada vez que llames a la herramienta.

[!WARNING] send-email (attachments[].filePath) y create-contact-import (filePath) leen archivos locales. En --http esta función está desactivada de forma predeterminada para que los clientes remotos no puedan leer el disco del servidor; usa --allowed-file-dirs para habilitarla en directorios específicos. En stdio, establece --allowed-file-dirs para impedir que un agente manipulado mediante inyección de prompts adjunte archivos de carpetas ajenas a las que elijas.

Herramientas del servidor MCP

El servidor MCP de Resend proporciona a tu agente de IA acceso nativo a toda la plataforma Resend mediante una única integración. Puedes administrar todos los aspectos de tu infraestructura de correo electrónico usando lenguaje natural.

  • Correos electrónicos: Envía, enumera, consulta, cancela, actualiza, comparte y envía correos electrónicos en lote. Recupera métricas de entrega e interacción. Admite HTML, texto sin formato, archivos adjuntos (archivo local, URL o base64), CC/CCO, responder a, programación, etiquetas, encabezados personalizados, envíos basados en temas y claves de idempotencia.
  • Correos electrónicos recibidos: Enumera y lee correos electrónicos entrantes. Enumera y descarga archivos adjuntos de correos recibidos.
  • Bandejas de entrada: Crea, enumera, consulta, actualiza y elimina bandejas de entrada. Lee y actualiza la configuración del agente de la bandeja de entrada. Enumera, busca, consulta, actualiza y elimina conversaciones, y añade, establece o elimina sus etiquetas. Enumera y consulta los correos de una conversación, y responde o reenvíalos con archivos adjuntos y encabezados personalizados. Crea, enumera, actualiza y elimina etiquetas. Crea, enumera, consulta, actualiza, elimina y envía borradores, con archivos adjuntos a partir de contenido base64 o una URL. Envía un correo nuevo desde una bandeja de entrada para iniciar una conversación. Admite claves de idempotencia al responder, reenviar, crear borradores, enviar borradores y enviar correos nuevos.
  • Plantillas: Crea, enumera, consulta, actualiza, publica, duplica y elimina plantillas de correo electrónico. Admite la composición del contenido de plantillas y marcadores de posición {{{VARIABLE}}}.
  • Contactos: Crea, enumera, consulta, actualiza y elimina contactos. Administra la pertenencia a segmentos, las suscripciones a temas y las importaciones de contactos CSV. Admite propiedades personalizadas de contactos.
  • Campañas: Crea, envía, cancela, duplica, enumera, consulta, actualiza y elimina campañas. Enumera los enlaces en los que se hizo clic en una campaña y sus destinatarios por tipo de evento (enviado, entregado, abierto, clic, rebotado, reclamación de spam, cancelación de suscripción, suprimido). Admite programación, marcadores de posición de personalización y texto de vista previa.
  • Automatizaciones: Crea, enumera, consulta, actualiza, duplica y elimina automatizaciones. Consulta las ejecuciones de una automatización.
  • Eventos: Envía eventos para activar automatizaciones para un contacto. Crea, actualiza y elimina definiciones de eventos.
  • Dominios: Crea, enumera, consulta, actualiza, elimina y verifica dominios de remitente. Configura el seguimiento, TLS y las capacidades de envío y recepción. Crea y verifica reclamaciones de dominio.
  • Segmentos: Crea, enumera, consulta, actualiza y elimina segmentos de audiencia.
  • Supresiones: Enumera, consulta, añade y elimina entradas de la lista de supresión, individualmente o en lote. Los rebotes permanentes y las reclamaciones de spam se suprimen automáticamente; añade direcciones manualmente para respetar las solicitudes de no contacto.
  • Temas: Crea, enumera, consulta, actualiza y elimina temas de suscripción.
  • Propiedades de contactos: Crea, enumera, consulta, actualiza y elimina atributos personalizados de contactos.
  • Claves de API: Crea, enumera, actualiza y elimina claves de API.
  • Webhooks: Crea, enumera, consulta, actualiza y elimina webhooks para notificaciones de eventos, e inspecciona su historial de entregas: los eventos enviados a un webhook, la carga útil de un evento y los intentos de entrega. Vuelve a poner un evento en cola para otra entrega y rota el secreto de firma de un webhook.
  • Registros: Enumera e inspecciona registros de solicitudes a la API, incluidos los cuerpos completos de las solicitudes y las respuestas.
  • Uso: Recupera información de uso y cuotas a nivel de cuenta: correos electrónicos, contactos, segmentos, campañas, créditos de IA, ejecuciones de automatizaciones, dominios y límite de solicitudes de la API.
  • Editor: Conéctate al editor visual del panel de Resend (y desconéctate de él) y lee el contenido de un borrador mientras colaboras en campañas y plantillas.

Desarrollo local

  1. Clona este proyecto y compílalo:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. Para usar la compilación local, sustituye el comando npx por la ruta a tu compilación 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"
      }
    }
  }
}

Pruebas en vivo con un cliente MCP

Durante el desarrollo, puedes probar los cambios en una sesión real de un cliente MCP mientras editas el código en otra.

La idea: ejecuta tsc --watch para recompilar continuamente dist/ y configura un cliente MCP independiente para que use el dist/index.js compilado desde otro directorio. Cuando quieras aplicar los cambios de código, reinicia la sesión del cliente MCP (los servidores MCP son procesos stdio de larga duración que no se recargan automáticamente).

Ejemplo con Claude Code:

  1. Ejecuta el observador de TypeScript para recompilar automáticamente al guardar:

    pnpm tsc --watch
    
  2. En otro directorio, crea un .mcp.json que apunte al resultado de la compilación:

    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. Inicia Claude Code desde ese directorio y usa las herramientas MCP. Después de hacer cambios en el código, inicia una nueva sesión de Claude Code para usar la nueva compilación.

El mismo principio se aplica a cualquier cliente MCP: separa el entorno de pruebas del entorno de desarrollo, usa una ruta absoluta a dist/index.js y vuelve a conectar el servidor MCP después de recompilar.

Pruebas con MCP Inspector

Nota: Asegúrate de haber compilado el proyecto primero (consulta la sección Desarrollo local anterior).

Uso del transporte Stdio

  1. Configura tu clave de API:

    export RESEND_API_KEY=re_your_key_here
    
  2. Inicia el inspector:

    pnpm inspector
    
  3. En el navegador (interfaz del inspector):

    • Elige stdio (iniciar un proceso).
    • Comando: node
    • Argumentos: dist/index.js (o la ruta completa a dist/index.js)
    • Entorno: RESEND_API_KEY=re_your_key_here (o déjalo en blanco si ya lo exportaste en la misma terminal).
    • Haz clic en Connect y luego usa "List tools" para verificar que el servidor funciona.

Uso del transporte HTTP

  1. Inicia el servidor HTTP en una terminal:

    node dist/index.js --http --port 3000
    
  2. Inicia el inspector en otra terminal:

    pnpm inspector
    
  3. En el navegador (interfaz del inspector):

    • Elige Streamable HTTP (conectarse a una URL).
    • URL: http://127.0.0.1:3000/mcp
    • Añade un encabezado personalizado: Authorization: Bearer re_your_key_here y activa el interruptor.
    • Haz clic en Connect y luego usa "List tools" para verificar que el servidor funciona.