spacemail-mcp

Un servidor MCP que le da a Claude acceso a uno o más buzones de Spacemail (correo empresarial de Spaceship).

El motivo de este diseño

La API pública de Spaceship en docs.spaceship.dev cubre dominios, DNS y SellerHub. No tiene endpoints de buzones, así que no hay nada que adaptar para el correo. Spacemail sí expone IMAP y SMTP estándar, habilitados por defecto, por lo que este servidor se comunica directamente con ellos:

El nombre de usuario es la dirección completa de Spacemail: la contraseña es la propia contraseña de ese buzón.

Related MCP server: IMAP MCP Server

Herramientas

Cada herramienta acepta un account opcional. Con un único buzón configurado, se ignora. Con varios, si se omite se usa el predeterminado. search_messages también acepta account: "*" para buscar en todos los buzones en una sola llamadan.

Dos omisiones deliberadas:

• Sin eliminación permanente. Lo peor que puede hacer cualquier herramienta es mover un mensaje a la Papelera, algo que se puede deshacer moviéndolo de vuelta.

• El envío es una opción de cada cuenta. send_message se rechaza a menos que allowSend sea true para esa cuenta específica. Déjalo desactivado y usa save_draft para que una persona sea quien presione enviar.

Configuración

1. Instalación

Requiere Node.js 18 o superior.

cd path/to/spacemail-mcp
npm install

2. Crear un accounts.json

Copia accounts.example.json a accounts.json y complétalo. Este archivo está en .gitignore.

{
  "accounts": [
    {
      "label": "personal",
      "user": "you@example.com",
      "password": "the-mailbox-password",
      "default": true,
      "fromName": "Your Name"
    },
    {
      "label": "work",
      "user": "hello@example.org",
      "password": "the-other-password"
    }
  ]
}

Campos por cuenta: label (cómo lo mencionas en el chat), user, password y, opcionalmente, default, fromName, allowSend, imapHost, imapPort, smtpHost y smtpPort.

Las etiquetas deben ser únicas. Si omites label, se deriva de la dirección; por eso, dos buzones en dominios distintos con la misma parte local (info@a.com y info@b.com) se convertirían ambos en info y el servidor no se iniciaría. Ponles etiquetas explícitas.

Las contraseñas se obtienen de Spacemail Manager: busca la suscripción, haz clic en los tres puntos junto al buzón y elige IMAP/POP3/SMTP. Restablece la contraseña ahí si ya no la conservas.

3. Registrarlo en la aplicación de escritorio de Claude

Ve a Configuración, luego a Desarrollador y luego a Editar config, que abrirá %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "spacemail": {
      "command": "node",
      "args": ["C:\\path\\to\\spacemail-mcp\\index.js"],
      "env": {
        "SPACEMAIL_CONFIG": "C:\\path\\to\\spacemail-mcp\\accounts.json"
      }
    }
  }
}

Las barras invertidas deben duplicarse en el JSON.com. Después, reinicia la app por completo desde la bandeja del sistema.

O con la CLI de Claude Code:

claude mcp add --transport stdio spacemail ^
  --env SPACEMAIL_CONFIG="C:\path\to\spacemail-mcp\accounts.json" ^
  -- node "C:\path\to\spacemail-mcp\index.js"

4. Verificación

Indica a Claude que ejecute test_connection sin argumento de cuentas. Probía todos los buzones yreporta cada uno como normal o failed de forma independiente, de modo que una contraseña no oculte al resto.

Otras formas de aportar credenciales

Se comprueban en este orden: la primera que exista gana.

1. Archivo de configuración (recomendado para dos o más buzones)

SPACEMAIL_CONFIG que apunta al archivo JSON de más arriba.

2. Variables de entorno numeradas

SPACEMAIL_1_USER, SPACEMAIL_1_PASSWORD, SPACEMAIL_1_LABEL, SPACEMAIL_1_DEFAULT, SPACEMAIL_1_ALLOW_SEND, SPACEMAIL_1_FROM_NAME y luego SPACEMAIL_2_*, y así sucesivamente, hasta 20.

3. Cuenta única

SPACEMAIL_USER y SPACEMAIL_PASSWORD, además de las opcionales SPACEMAIL_IMAP_HOST, SPACEMAIL_IMAP_PORT, SPACEMAIL_SMTP_HOST, SPACEMAIL_SMTP_PORT, SPACEMAIL_ALLOW_SEND y SPACEMAIL_FROM_NAME.

Solución de problemas

El servidor no arranca. Sede produces with an specific message on stdout: unreadable config file, missing password, duplicate label, or no mailboxes configured at all. Run node index.js in the folder directly to see it.

Falla un buzón y los demás no. Ejecuta test_connection sin argumentos. Cada cuenta se informa por separado. La causa más frecuente es que el nombre de usuario no sea la dirección completa del correo, o que en Spacemail Manager tenga esa cuenta desactivado el IMAP.

El servidor aparece como desconectado en Claude. Los subprocesos MCP se inician con un entorno distinto al de la terminal, por lo que node puede no estar en PATH. Usar la ruta absoluta de node.exe, que te da where node en PowerShell.

search_messages no encuentra nada. Las rutas de las carpetas distinguen entre mayúsculas y minúsculas y varían. Ejecuta primero list_folders y usa el valor exacto de path que devuelva.

Cuando se rechaza el envío. allowSend debe ser true para esa cuenta específica. Spacemail también limita el volumen de envío según el plan de precios.