@multimail/mcp-server

Servidor MCP para MultiMail. Dale a tu agente su propia dirección de correo electrónico con supervisión humana gradual, desde la aprobación total hasta el envío autónomo.

Inicio rápido

npx @multimail/mcp-server

Establece MULTIMAIL_API_KEY para obtener acceso completo, o ejecútalo sin ella para crear una cuenta primero. Obtén una clave en multimail.dev.

Al usar MultiMail, aceptas los Términos de servicio y la Política de uso aceptable.

Related MCP server: MCP Email Server

Configuración

Opción A: Servidor remoto (recomendado)

No requiere instalación. Conéctate directamente a nuestro servidor alojado. Se autentica mediante OAuth en el navegador.

{
  "mcpServers": {
    "multimail": {
      "type": "url",
      "url": "https://mcp.multimail.dev/mcp"
    }
  }
}

Funciona con Claude.ai, Claude Desktop, Claude Code y cualquier cliente que admita servidores MCP remotos.

Opción B: Servidor local (stdio)

Ejecuta el servidor localmente. La clave API se pasa como una variable de entorno.

{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_...",
        "MULTIMAIL_MAILBOX_ID": "01KJ1NHN8J..."
      }
    }
  }
}

Dónde añadir esto

Cliente	Archivo de configuración
Claude Code	`~/.claude/.mcp.json`
Claude Desktop	`claude_desktop_config.json`
Cursor	`.cursor/mcp.json` en tu proyecto
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Copilot (VS Code)	`.vscode/mcp.json` en tu proyecto
OpenCode	`mcp.json` en tu proyecto
ChatGPT Desktop	Ajustes > Servidores MCP
Cualquier cliente MCP	Consulta la documentación de tu cliente para la ubicación de la configuración

Variables de entorno

Variable	Requerido	Descripción
`MULTIMAIL_API_KEY`	Sí	Tu clave API de MultiMail (`mm_live_...`)
`MULTIMAIL_MAILBOX_ID`	No	ID del buzón predeterminado. Si no se establece, pasa `mailbox_id` a cada herramienta o llama primero a `list_mailboxes`.
`MULTIMAIL_API_URL`	No	URL base de la API. Por defecto es `https://api.multimail.dev`.

Configuración de la primera ejecución

En el primer uso, MultiMail te pedirá que configures tu buzón. También puedes ejecutar esto explícitamente usando la herramienta configure_mailbox:

Modo de supervisión: Cuánta aprobación humana se requiere (gated_send, monitored, autonomous, etc.)
Nombre para mostrar: Nombre del remitente que se muestra en los correos electrónicos
CC/BCC predeterminados: Copiar automáticamente direcciones en todos los correos electrónicos salientes
Programación: Habilitar/deshabilitar el envío programado y establecer el tiempo de espera de la puerta predeterminado
Firma: Bloque de firma de correo electrónico

Si omites este paso, MultiMail te lo recordará en tu primera llamada a la herramienta.

Herramientas

Herramienta	Descripción
`list_mailboxes`	Lista todos los buzones disponibles para esta clave API
`configure_mailbox`	Configura las preferencias del buzón: modo de supervisión, nombre para mostrar, CC/BCC, programación, firma
`send_email`	Envía un correo electrónico con un cuerpo en markdown. Admite archivos adjuntos, `idempotency_key` y `send_at` para entrega programada.
`check_inbox`	Lista correos electrónicos con filtros: estado, remitente, asunto, rango de fechas, dirección, archivos adjuntos, paginación de cursor
`read_email`	Obtiene el contenido completo del correo electrónico. Devuelve metadatos confiables y el cuerpo no confiable como bloques de contenido separados.
`reply_email`	Responde a un correo electrónico en su hilo existente. Admite archivos adjuntos y `idempotency_key`.
`download_attachment`	Descarga un archivo adjunto de correo electrónico como base64 con tipo de contenido
`get_thread`	Obtiene todos los correos electrónicos en un hilo de conversación con participantes y metadatos
`cancel_message`	Cancela un correo electrónico pendiente o programado
`schedule_email`	Programa un correo electrónico para entrega futura con un tiempo `send_at` requerido. Edita o cancela antes de que se envíe.
`edit_scheduled_email`	Edita el tiempo de entrega, destinatarios, asunto o cuerpo de un correo electrónico programado antes de que se envíe
`update_mailbox`	Actualiza la configuración del buzón (nombre para mostrar, modo de supervisión, firma, webhooks)
`update_account`	Actualiza la configuración de la cuenta (nombre de la organización, correo electrónico de supervisión, dirección física)
`delete_mailbox`	Elimina permanentemente un buzón (requiere ámbito de administrador)
`request_challenge`	Solicita un desafío de prueba de trabajo ALTCHA para la creación de cuenta (no requiere clave API)
`create_account`	Crea una nueva cuenta con un desafío de PoW resuelto (no requiere clave API)
`resend_confirmation`	Reenvía el correo electrónico de activación con un nuevo código (no requiere clave API)
`activate_account`	Activa una cuenta usando el código del correo electrónico de confirmación (no requiere clave API)
`tag_email`	Establece, obtiene o elimina etiquetas clave-valor en correos electrónicos (memoria persistente del agente)
`add_contact`	Añade un contacto a tu libreta de direcciones con etiquetas opcionales
`search_contacts`	Busca en la libreta de direcciones por nombre o correo electrónico
`get_account`	Obtiene el estado de la cuenta, plan, cuota, envío habilitado, nivel de cumplimiento
`create_mailbox`	Crea un nuevo buzón (requiere ámbito de administrador)
`request_upgrade`	Solicita una actualización del modo de supervisión (escalera de confianza)
`apply_upgrade`	Aplica un código de actualización del operador
`get_usage`	Comprueba la cuota y las estadísticas de uso para el período de facturación
`list_pending`	Lista los correos electrónicos que esperan una decisión de supervisión (requiere ámbito de supervisión)
`decide_email`	Aprueba o rechaza un correo electrónico pendiente (requiere ámbito de supervisión)
`delete_contact`	Elimina un contacto de la libreta de direcciones
`check_suppression`	Lista las direcciones de correo electrónico suprimidas
`remove_suppression`	Elimina una dirección de la lista de supresión
`list_api_keys`	Lista todas las claves API (requiere ámbito de administrador)
`create_api_key`	Crea una nueva clave API con ámbitos (requiere ámbito de administrador + aprobación del operador; las combinaciones de `send`+`oversight` son rechazadas para evitar la auto-aprobación)
`revoke_api_key`	Revoca una clave API (requiere ámbito de administrador)
`get_audit_log`	Obtiene el registro de auditoría de la cuenta (requiere ámbito de administrador)
`delete_account`	Elimina permanentemente la cuenta y todos los datos (requiere ámbito de administrador)
`wait_for_email`	Bloquea hasta que llegue un nuevo correo electrónico que coincida con los filtros, o tiempo de espera (máx. 120s)
`create_webhook`	Crea una suscripción de webhook para notificaciones de eventos de correo electrónico en tiempo real
`list_webhooks`	Lista todas las suscripciones de webhook para esta cuenta
`delete_webhook`	Elimina una suscripción de webhook

Cómo funciona

Escribes los cuerpos de los correos electrónicos en markdown. MultiMail convierte a HTML formateado para la entrega.
El correo electrónico entrante llega como markdown limpio. Sin análisis de HTML ni decodificación MIME.
El enhebrado es automático. Responde a un correo electrónico y los encabezados se establecen correctamente.
Los envíos devuelven el estado pending_scan mientras el correo electrónico se escanea en busca de amenazas. Si tu buzón utiliza supervisión controlada, el estado cambia a pending_send_approval para revisión humana. No vuelvas a intentar ni reenviar.
Verifica otros agentes comprobando el encabezado firmado X-MultiMail-Identity en los correos electrónicos recibidos.

Desarrollo

npm install
npm run dev   # Run with tsx (no build needed)
npm run build # Compile TypeScript
npm start     # Run compiled version

Pruebas

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | MULTIMAIL_API_KEY=mm_live_... node dist/index.js

Licencia

MIT

MultiMail