Assistant Mail

assistantmail-mcp

Servidor MCP para AssistantMail — brinda a los agentes de IA un buzón administrado para enviar y recibir correos electrónicos.

Diseñado para operadores personales y de equipos pequeños de OpenClaw / Hermes que desean correo de agente con lista blanca, consentimiento, retención y límites de gasto que tú controlas. Listado en ClawHub para instalación fácil — no es un respaldo oficial de OpenClaw.

Obtener Gratis · Documentación · Sitio Web · Privacidad · Términos · Contribuir

OpenClaw / ClawHub

openclaw skills install @assistantmail/assistant-mail

Luego configura tu cliente MCP para ejecutar este servidor y establece ASSISTANT_MAIL_API_KEY (ejemplos de Claude Desktop y Cursor a continuación). Habilidad: assistant-mail en ClawHub. El mismo MCP funciona con Hermes.

Instalación

npx -y @assistantmail/assistantmail-mcp

Node 24+.

Claude Desktop

{
  "mcpServers": {
    "assistantmail": {
      "command": "npx",
      "args": ["-y", "@assistantmail/assistantmail-mcp"],
      "env": {
        "ASSISTANT_MAIL_API_KEY": "amk_..."
      }
    }
  }
}

Cursor / VS Code (.cursor/mcp.json o .vscode/mcp.json)

{
  "servers": {
    "assistantmail": {
      "command": "npx",
      "args": ["-y", "@assistantmail/assistantmail-mcp"],
      "env": {
        "ASSISTANT_MAIL_API_KEY": "amk_..."
      }
    }
  }
}

Requisitos previos

1. Crea una cuenta gratuita mediante el enlace Obtener Gratis de arriba (1 agente, 25/día; límites actuales: Documentación).
2. Ve a API Keys y crea una clave (amk_...). Cópiala de inmediato — solo se muestra una vez.
3. Establece ASSISTANT_MAIL_API_KEY; llama a assistantmail_list_mailboxes para obtener tu UUID de mailboxId. Las rutas de la API de correo usan ese UUID, no una dirección de correo electrónico.

Planes de pago: actualiza solo dentro de la aplicación (no mediante Payment Links). Usa Upgrade en la aplicación AssistantMail — el pago no se vende a través de Stripe Payment Links. Documentación: assistant-mail.ai/docs

Registro Oficial de MCP

El listado está activo como io.github.AssistantMail/assistantmail-mcp en el Registro Oficial de MCP. Documentación del producto: assistant-mail.ai/docs.

El empaquetado vive en server.json. Después de un aumento de versión, vuelve a publicar con mcp-publisher — consulta docs/MCP_REGISTRY.md.

Variables de entorno

Variable	Predeterminado	Descripción
ASSISTANT_MAIL_API_KEY	(ninguno)	Clave de API (amk_...). Puede omitirse si se pasa por herramienta.
ASSISTANT_MAIL_API_BASE_URL	https://api.assistant-mail.ai	La API pública para el servicio AssistantMail

Herramientas

Diagnóstico

Herramienta	Descripción
assistantmail_health	Verifica que el servidor MCP esté ejecutándose y confirma la URL base de la API. No se requiere clave de API.

Cuenta

Herramienta	Descripción
assistantmail_get_me	Obtén el perfil de la cuenta y el nivel del plan.
assistantmail_get_inbound_policy	Obtén la política de correo entrante actual (quién puede enviar a los buzones de esta cuenta).
assistantmail_update_inbound_policy	Actualiza la política entrante (si el nivel de cuenta seleccionado lo permite). Valores aceptados: owner, list, sent. Usa allowedSenders con list.

Buzones

Herramienta	Descripción
assistantmail_list_mailboxes	Lista todos los buzones de la cuenta. Devuelve mailboxId necesario para operaciones de mensajes.
assistantmail_create_mailbox	Crea un nuevo buzón (si el nivel de cuenta seleccionado lo permite), especificando opcionalmente displayName y address.
assistantmail_get_mailbox	Obtiene metadatos de un solo buzón por mailboxId.
assistantmail_update_mailbox	Actualiza el nombre visible de un buzón.
assistantmail_delete_mailbox	Elimina permanentemente un buzón y todos sus mensajes. ESTA ACCIÓN NO TIENE CONFIRMACIÓN. ÚSALA CON CUIDADO.

Mensajes

Herramienta	Descripción
assistantmail_list_messages	Lista mensajes entrantes y salientes de un buzón. Admite since (marca de tiempo ISO) y limit (máx. 100).
assistantmail_get_message	Obtiene un solo mensaje, incluidos textBody y htmlBody. Los cuerpos solo se devuelven dentro de la ventana de retención del plan; bodyExpired: true se establece si la ventana ha transcurrido.
assistantmail_send_email	Pone en cola un correo saliente. Requiere to, subject y al menos uno de text o html.
assistantmail_reply_message	Responde a un mensaje existente. Requiere messageId y al menos uno de text o html; los destinatarios y el asunto se derivan automáticamente.
assistantmail_delete_messages	Elimina mensajes mediante el arreglo messageIds, o pasa deleteAll: true para vaciar el buzón.
assistantmail_get_usage	Obtiene el uso de cuota de envío diario y mensual de un buzón. Un límite de null significa ilimitado.

Destinatarios

Herramienta	Descripción
assistantmail_list_recipients	Lista destinatarios aprobados y pendientes de la cuenta.
assistantmail_add_recipient	Agrega un destinatario. Envía un correo de invitación de consentimiento cuando el plan de la cuenta lo requiere.
assistantmail_remove_recipient	Elimina un destinatario de la lista permitida.

Herramientas de referencia

Estas devuelven detalles de endpoints REST sin procesar en lugar de llamar a la API. Úsalas cuando necesites construir una solicitud manualmente o inspeccionar la URL exacta y el esquema de respuesta.

Herramienta	Descripción
assistantmail_send_email_reference	Endpoint, encabezados y campos del cuerpo para POST /v1/mailboxes/{mailboxId}/messages.
assistantmail_list_messages_reference	Endpoint y parámetros de consulta para GET /v1/mailboxes/{mailboxId}/messages.
assistantmail_get_message_reference	Endpoint y esquema de respuesta para GET /v1/mailboxes/{mailboxId}/messages/{messageId}.
assistantmail_get_usage_reference	Endpoint y esquema de respuesta para GET /v1/mailboxes/{mailboxId}/usage.

Inicio rápido

API_KEY="amk_..."
BASE="https://api.assistant-mail.ai"

# 1) Discover your mailboxId
curl "$BASE/v1/mailboxes" -H "x-api-key: $API_KEY"

# 2) Send an email
curl -X POST "$BASE/v1/mailboxes/<mailboxId>/messages" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"recipient@example.com","subject":"Hello","text":"Hi there"}'

# 3) Read inbox
curl "$BASE/v1/mailboxes/<mailboxId>/messages" -H "x-api-key: $API_KEY"

Ejemplos de llamadas a herramientas

{ "tool": "assistantmail_list_mailboxes", "input": { "apiKey": "amk_..." } }

{
  "tool": "assistantmail_list_messages",
  "input": { "mailboxId": "<uuid>", "limit": 20, "since": "2026-01-01T00:00:00.000Z" }
}

{
  "tool": "assistantmail_get_message",
  "input": { "mailboxId": "<uuid>", "messageId": "<uuid>" }
}

{
  "tool": "assistantmail_send_email",
  "input": {
    "mailboxId": "<uuid>",
    "to": "recipient@example.com",
    "subject": "Hello",
    "text": "Hi there"
  }
}

{
  "tool": "assistantmail_reply_message",
  "input": {
    "mailboxId": "<uuid>",
    "messageId": "<uuid>",
    "text": "Thanks for the update."
  }
}

Si ASSISTANT_MAIL_API_KEY está establecido en el entorno del servidor, apiKey puede omitirse de todas las entradas de herramientas.

---

AssistantMail · Política de Privacidad · Términos de Uso