ai-mail-mcp

Servicio de correo que conecta tu propio dominio de correo a cualquier cliente MCP. Admite envío (adjunta automáticamente firma personal / enlace de página de presentación de marca), recepción, lectura del contenido del correo y prueba de conexión.

Compatible con WorkBuddy, Claude Desktop, Cursor y todas las herramientas que soportan el protocolo MCP. Mediante el despliegue en la nube, se permite que los clientes de escritorio y móviles de WorkBuddy compartan la misma entrada de correo, pudiendo gestionar sus asuntos de correo con lenguaje natural en cualquier momento y lugar.

Características

• ✉️ send_email: Envía correos, adjunta automáticamente la firma personal "enviado automáticamente por xx a través de xx" (incluye enlace a página de presentación, que puede servir como entrada de IP personal)

• 📥 get_recent_emails: Obtiene la lista de correos de los últimos N días (asunto / remitente / hora)

• 📖 get_email_content: Lee el cuerpo completo del correo y la información de los archivos adjuntos según el UID

• 🔌 test_email_connection: Prueba de un solo clic la conexión SMTP/IMAP

• 🚀 Dos modos de transferencia: stdio (depuración local) / SSE (despliegue remoto en la nube)

• 🔐 Autenticación mediante Bearer Token en el endpoint, todas las credenciales se gestionan mediante variables de entorno, nunca codificadas fijamente.

Arquitectra

┌──────────────┐   HTTPS + Bearer   ┌──────────────────┐   SMTP/IMAP   ┌──────────────┐
│ WorkBuddy    │ ─────────────────▶ │ ai-mail-mcp      │ ────────────▶ │ 你的域名邮箱   │
│ 桌面端 / 移动端 │                   │ (云端 MCP Server) │               │ you@your.com │
└──────────────┘                   └──────────────────┘               └──────────────┘

El despliegue en la nube es clave: un endpoint HTTps al qu pueden conectar tanto escritorio como móviles, no es neceario que la máquina local esté encendida.

Inicicio rápido

1. Configurar varables de entono

cp .env.example .env
# 编辑 .env，填入你的邮箱账号、授权码、SMTP/IMAP 地址、Bearer Token

2A. Depuración local (stdio)

npm install
MCP_TRANSPORT=stdio node server.js

2B. Despliegue en la nube (SE, recomndado)

Se neceitar un servidor con IP pública + un domonio (HTTPS). n GXP4

Lu ego usar ngix como proxy inverso + acem. sh/ certot para obtener certificados HTPS (hay ejemlos con commentarios en docker-compose.yml), obteniendo un endpoint de la forma https://mcp.ur-dominio.com/mail-mcp/sse.

3. Integrar con WorkBuddy (conector personalizado)

Editar ~/.workbuddy/mcp.json:

{
  "mcpServers": {
    "ai-mail-mcp": {
      "type": "sse",
      "url": "https://mcp.your-domain.com/mail-mcp/sse",
      "headers": {
        "Authorization": "Bearer 你的随机Token"
      }
    }
  }
}

En la página de administración de conectores de WorkBuddy, haga clic en Trust / Habilitar y reinicie la esión, lugo podrá en el diólogo:

• "Enviar un correo a x, asunto…, cuero…"

• "Ver mis correos de los últios 3 días, resumir cuáes neceitan respuesta"

• "Cada mañana a las 9 enviar a mi correo un resumen de los correos de ayer"

Lista de herramintas

Consjos de seguriad

• MCP_BEARER_TKEN debe configurarse con una cadena larga sufientemente aleatoria (genrada con opensl rand -hex 32) y guardala de forma segura. *. env y las credenciales reles no deben enviarse a ningún repostorio; este repostorio de docmentación solo inclu env.exmple.

• Se recominda usar una cuenta de correo independiente con permisos mínimos (solo enviar/recibir, sin permos de borado/administraciión). n* Autohosedado significa que los datos de correo estén siempre en tu propio servidor, no se entregán a terceros.

Licencia

MIT