Skip to main content
Glama
pijusz

mcpj-mailtrap

by pijusz

Inicio rápido

1. Obtén tu token de API

Obtén un token de API en Mailtrap API Tokens.

2. Añádelo a Claude Code

Mínimo

claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- npx mcpj-mailtrap

Completo

claude mcp add mailtrap \
  -e MAILTRAP_API_TOKEN=your_token \
  -e MAILTRAP_SENDING_TOKEN=your_sending_token \
  -e MAILTRAP_ACCOUNT_ID=12345 \
  -e MAILTRAP_DEFAULT_FROM_EMAIL=noreply@yourdomain.com \
  -e MAILTRAP_TEST_INBOX_ID=12345 \
  -- npx mcpj-mailtrap

Eso es todo. Reinicia Claude Code y las herramientas estarán disponibles.

También funciona con bunx mcpj-mailtrap@latest si tienes Bun. Requiere Node 18+ cuando se ejecuta mediante npx.

Claude Desktop / Cursor

Mínimo

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token"
      }
    }
  }
}

Completo

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token",
        "MAILTRAP_SENDING_TOKEN": "your_sending_token",
        "MAILTRAP_ACCOUNT_ID": "12345",
        "MAILTRAP_DEFAULT_FROM_EMAIL": "noreply@yourdomain.com",
        "MAILTRAP_TEST_INBOX_ID": "12345"
      }
    }
  }
}

Descarga un binario precompilado desde Releases:

Plataforma

Archivo

macOS (Apple Silicon)

mcpj-mailtrap-darwin-arm64

macOS (Intel)

mcpj-mailtrap-darwin-x64

Linux

mcpj-mailtrap-linux-x64

Windows

mcpj-mailtrap-windows-x64.exe

macOS / Linux:

curl -Lo mcpj-mailtrap https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-darwin-arm64
chmod +x mcpj-mailtrap
sudo mv mcpj-mailtrap /usr/local/bin/
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- /usr/local/bin/mcpj-mailtrap

Windows (PowerShell):

Invoke-WebRequest -Uri "https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\mcpj-mailtrap.exe"
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- "%LOCALAPPDATA%\mcpj-mailtrap.exe"

Related MCP server: Inbound Email MCP Server

Herramientas (48)

Análisis

Herramienta

Descripción

get_stats

Estadísticas de envío: tasas de entrega, rebote, apertura, clics y spam. Agrupa por dominio, categoría, ESP o fecha

Registros de correo

Herramienta

Descripción

get_email_logs

Lista los correos enviados con filtrado por estado, flujo y fecha. Paginación basada en cursor

get_email_log

Detalle de un mensaje individual con la línea temporal de eventos de entrega

get_suppressions

Lista los correos suprimidos (rebotes, quejas de spam, bajas)

delete_suppression

Vuelve a habilitar el envío a una dirección suprimida

check_list_hygiene

Encuentra correos suprimidos que aún existen en listas de contactos y sugiere acciones de limpieza exactas

Envío

Herramienta

Descripción

send_email

Envía mediante el flujo transaccional o masivo. Admite HTML, texto o plantillas

batch_send

Envía hasta 500 correos en una sola solicitud

send_test_email

Envía a una bandeja de entrada de sandbox para pruebas, con valores predeterminados opcionales de entorno para la bandeja y el remitente

Plantillas

Herramienta

Descripción

list_templates

Lista todas las plantillas de correo

get_template

Obtiene los detalles de la plantilla, incluido el cuerpo HTML/texto

create_template

Crea una nueva plantilla

update_template

Actualiza una plantilla existente

delete_template

Elimina una plantilla

render_react_email

Renderiza un archivo de componente react-email (.tsx, .jsx, .js, .mjs) a HTML + texto plano

Contactos

Herramienta

Descripción

create_contact

Crea un contacto con correo, campos personalizados y pertenencia a listas

get_contact

Obtiene un contacto por UUID o correo

update_contact

Actualiza campos del contacto, pertenencia a listas y estado de suscripción

delete_contact

Elimina un contacto

trigger_contact_event

Activa automatizaciones para un contacto

list_contact_lists

Lista todas las listas de contactos

get_contact_list

Obtiene una lista de contactos individual

create_contact_list

Crea una nueva lista de contactos

update_contact_list

Renombra una lista de contactos

delete_contact_list

Elimina una lista de contactos

manage_contact_field

Lista, obtiene, crea, actualiza o elimina campos personalizados de contactos

import_contacts

Importación masiva de hasta 50 000 contactos, o consulta del estado de importación

export_contacts

Inicia la exportación de contactos o consulta el estado de exportación

Sandbox de correo

Herramienta

Descripción

list_projects

Lista los proyectos de sandbox con sus bandejas de entrada

get_project

Obtiene un proyecto individual

manage_project

Crea, actualiza o elimina un proyecto

list_inboxes

Lista todas las bandejas de entrada de sandbox

get_inbox

Obtiene los detalles de la bandeja (credenciales ocultas por defecto)

manage_inbox

Crea, actualiza, limpia, marca como leído, restablece credenciales o elimina

get_messages

Lista los mensajes en una bandeja de entrada de sandbox

get_message

Obtiene el cuerpo del mensaje en formato HTML/texto/bruto/EML, con adjuntos opcionales

analyze_message

Informe combinado de puntuación de spam + análisis HTML + cabeceras

forward_message

Reenvía un mensaje de prueba a un correo

Dominios

Herramienta

Descripción

list_domains

Lista los dominios de envío con estado DNS

get_domain

Obtiene los detalles del dominio, incluidos los registros DNS

manage_domain

Crea o elimina un dominio de envío

send_domain_setup_instructions

Envía por correo las instrucciones de configuración DNS a un colega

Cuentas

Herramienta

Descripción

list_accounts

Lista las cuentas u obtiene una por ID

get_billing_usage

Límites del plan y uso actual

manage_account_access

Lista, elimina, actualiza permisos y consulta recursos

manage_api_token

Lista, obtiene, crea, elimina o restablece tokens de API

Configuración

Variable

Obligatoria

Valor predeterminado

Descripción

MAILTRAP_API_TOKEN

Sí

—

Token de API general de mailtrap.io/api-tokens

MAILTRAP_SENDING_TOKEN

No

MAILTRAP_API_TOKEN

Token independiente para solicitudes transaccionales y masivas de send.api

MAILTRAP_ACCOUNT_ID

No

detección automática

ID de cuenta predeterminado

MAILTRAP_DEFAULT_FROM_EMAIL

No

—

Correo del remitente predeterminado para send_email / send_test_email

MAILTRAP_TEST_INBOX_ID

No

—

ID de bandeja de sandbox predeterminada para send_test_email

DEBUG

No

—

Habilita el registro de depuración

Actualizaciones

Con npx @latest (recomendado): siempre obtienes la última versión; no se necesitan actualizaciones manuales.

Con un binario: el servidor comprueba si hay nuevas versiones al iniciar y registra en stderr si está desactualizado:

[mcpj-mailtrap] Update available: v0.2.0 (current: v0.1.0)

Comprueba tu versión instalada:

mcpj-mailtrap --version

Desarrollo

Requiere Bun.

git clone https://github.com/pijusz/mcp-mailtrap.git
cd mcp-mailtrap
bun install
bun test           # tests
bun run build      # standalone binary
bun run inspect    # MCP Inspector
bun run check      # biome format + lint

Licencia

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Enables interaction with Mailosaur email and SMS testing services, allowing message management, server configuration, file downloads, spam analysis, and TOTP code retrieval via natural language.
    29
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to interact with Mailjet's contact, campaign, segmentation, statistics, and workflow APIs for managing email marketing operations through natural language.
    165 npm
    13
    Apache 2.0