@darkroomhq/protonmail-mcp

Servidor MCP que otorga a los asistentes de IA acceso completo a tu cuenta de ProtonMail a través de Proton Bridge. Lee, envía, busca y gestiona correos electrónicos a través de cualquier cliente compatible con MCP.

Requisitos

• Proton Bridge ejecutándose localmente y con sesión iniciada

• Node.js 18+

Related MCP server: Proton Mail MCP Server

Instalación

npm install -g @darkroomhq/protonmail-mcp

O úsalo sin instalar:

npx @darkroomhq/protonmail-mcp

Configuración

Añádelo a la configuración de tu cliente MCP (por ejemplo, claude_desktop_config.json):

{
  "mcpServers": {
    "protonmail": {
      "command": "protonmail-mcp",
      "env": {
        "PROTONMAIL_USERNAME": "your@protonmail.com",
        "PROTONMAIL_PASSWORD": "bridge-app-password"
      }
    }
  }
}

Con npx (no requiere instalación global):

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["-y", "@darkroomhq/protonmail-mcp"],
      "env": {
        "PROTONMAIL_USERNAME": "your@protonmail.com",
        "PROTONMAIL_PASSWORD": "bridge-app-password"
      }
    }
  }
}

Nota: PROTONMAIL_PASSWORD es la contraseña de la aplicación Bridge que se muestra en Proton Bridge, no la contraseña de tu cuenta de ProtonMail.

Todas las variables de entorno

Herramientas

Ejemplos de prompts

Leer y resumir

• "Resume mis correos no leídos de esta semana."

• "Lee el último correo de alice y dime qué está pidiendo."

Buscar

• "Busca todos los correos sobre el informe del segundo trimestre de los últimos 30 días."

• "Busca cualquier correo marcado en mi carpeta de Enviados."

Enviar y responder

• "Envía un correo a bob avisándole de que la reunión se traslada al jueves a las 3pm."

• "Responde al último correo del equipo de diseño y pide los mockups actualizados."

Operaciones en bloque

• "Elimina todos los correos de IGN en mi bandeja de entrada."

• "Marca todos los boletines no leídos como leídos."

• "Mueve todos los correos de noreply@github.com a la carpeta GitHub."

• "¿Cuántos correos marcados tengo del último mes?" (usa simulación)

Organizar

• "Mueve todos los boletines de mi bandeja de entrada a la carpeta Boletines."

• "Marca los tres correos más recientes de mi jefe."

• "Elimina todos los correos de la carpeta Spam."

• "Crea una carpeta llamada 'Recibos' y mueve allí todas las confirmaciones de compra."

• "Crea una etiqueta llamada 'Urgente' para los correos que necesitan atención inmediata."

• "Cambia el nombre de la carpeta 'Proyectos antiguos' a 'Archivo'."

Estado

• "Comprueba si Proton Bridge está conectado."

Consejos de rendimiento

• Paginación por cursor: Usa beforeUid (devuelto como nextCursor) en lugar de page para una paginación estable que no se vea afectada por la llegada de nuevos correos entre solicitudes.

• Solo encabezados: Usa headersOnly: true en readEmail para evitar descargar todo el cuerpo del mensaje; útil cuando solo necesitas metadatos.

• Truncamiento del cuerpo: Usa maxBodyLength en readEmail para limitar el tamaño del cuerpo (por ejemplo, 2000 caracteres) y evitar respuestas grandes en mensajes extensos.

• Acciones en bloque: Usa bulkAction con criteria de búsqueda en lugar de iterar sobre correos individuales. Ejecuta un único IMAP SEARCH + un único comando en bloque, independientemente de cuántos correos coincidan.

• Simulación (Dry run): bulkAction tiene dryRun: true por defecto; previsualiza los correos afectados antes de realizar operaciones destructivas.

Desarrollo

npm install
npm run build   # compile TypeScript
npm run dev     # watch mode