English | Español | 简体中文 | Português (Brasil) | Deutsch

Nota de traduccion: El README.md en ingles es la fuente canonica. Esta traduccion puede tener un pequeno retraso respecto a las actualizaciones.

email-agent-mcp de UseJunior -- conectividad de correo electronico para agentes de IA.

Agent Email es un servidor MCP de codigo abierto escrito en TypeScript que brinda a los agentes de IA acceso seguro al correo electronico. Expone operaciones de correo a traves del Model Context Protocol para cualquier entorno de ejecucion compatible con MCP -- Claude Code, Gemini CLI, Cursor, Goose, y mas. La configuracion de seguridad por defecto impide que los agentes envien correo hasta que configures explicitamente una lista de permitidos.

Los agentes de IA necesitan leer, responder y actuar sobre el correo electronico, pero las APIs de correo son complejas. Flujos OAuth, consultas delta de Graph, suscripciones push de Gmail, conversion de HTML a markdown, semantica de hilos -- cada proveedor tiene sus propias particularidades.

Agent Email encapsula esta complejidad en herramientas MCP deterministas con medidas de seguridad:

• listas de permitidos de envio y recepcion que controlan con quien pueden comunicarse los agentes
• eliminacion deshabilitada por defecto (requiere activacion explicita)
• sanitizacion de errores que elimina claves de API, rutas de archivos y trazas de pila
• sandboxing de archivos de cuerpo con proteccion contra recorrido de rutas (path traversal)

Agrega lo siguiente a ~/.claude/settings.json o al archivo .claude/settings.json de tu proyecto:

{
  "mcpServers": {
    "email-agent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "email-agent-mcp"]
    }
  }
}

gemini extensions install https://github.com/UseJunior/email-agent-mcp

// .cursor/mcp.json
{
  "mcpServers": {
    "email-agent-mcp": {
      "command": "npx",
      "args": ["-y", "email-agent-mcp"]
    }
  }
}

npx -y email-agent-mcp

El asistente de configuracion interactivo te guiara a traves de la configuracion de OAuth y la seleccion de buzon.

Agent Email expone 15 herramientas MCP:

Usa email-agent-mcp configure --provider gmail para ejecutar el flujo OAuth local en el navegador, o agrega un archivo manual en ~/.email-agent-mcp/tokens/. Consulta packages/provider-gmail/README.md.

Agent Email se distribuye con valores por defecto restrictivos que puedes flexibilizar segun sea necesario:

• Lista de permitidos de envio: vacia por defecto -- los agentes no pueden enviar correo hasta que agregues destinatarios
• Lista de permitidos de recepcion: acepta todo por defecto -- controla que remitentes activan el observador
• Eliminacion deshabilitada: los agentes no pueden eliminar correo a menos que establezcas user_explicitly_requested_deletion: true
• Sanitizacion de errores: las claves de API, rutas de archivos y trazas de pila se eliminan de las respuestas de error
• Sandboxing de archivos de cuerpo: sin recorrido ../, sin enlaces simbolicos, deteccion de binarios

• CI se ejecuta en cada pull request y push a main (lint, verificacion de tipos, pruebas en Node 20 + 22)
• Escaneo de seguridad con CodeQL y Semgrep
• Cobertura publicada en Codecov
• Cumplimiento de trazabilidad OpenSpec via npm run check:spec-coverage
• 310 pruebas en 34 archivos de pruebas
• Mantenedor: Steven Obiajulu

email-agent-mcp/
├── packages/
│   ├── email-core          Acciones principales, motor de contenido, seguridad
│   ├── email-mcp           Adaptador de servidor MCP, CLI, observador
│   ├── provider-microsoft  Proveedor de Microsoft Graph
│   ├── provider-gmail      Proveedor de Gmail API
│   └── email-agent-mcp         Empaquetado de distribucion (punto de entrada npx)
├── openspec/               Desarrollo guiado por especificaciones
└── scripts/                Scripts de CI y validacion

Publicacion basada en etiquetas (tags) via GitHub Actions con publicacion confiable OIDC de npm. Los 5 paquetes se publican en orden de dependencia con --provenance.

Si. Ejecuta npx email-agent-mcp para iniciar el servidor MCP y luego configuralo en los ajustes de Claude Code.

No. La lista de permitidos de envio esta vacia por defecto. Los agentes no pueden enviar ningun correo hasta que configures explicitamente los destinatarios permitidos.

Los tokens OAuth son gestionados por MSAL (Microsoft) y se almacenan en el llavero de tu sistema operativo o en archivos de configuracion locales en ~/.email-agent-mcp/. Agent Email nunca almacena contrasenas en texto plano.

Si. Puedes configurar Microsoft 365 y Gmail simultaneamente. Las acciones de lectura usan tu buzon principal por defecto; las acciones de escritura requieren especificar un buzon cuando hay multiples configurados.

Consulta las instrucciones de desarrollo en el README principal en ingles.

npm ci
npm run build
npm run lint --workspaces --if-present
npm run test:run
npm run check:spec-coverage

• Safe DOCX Suite -- edicion quirurgica de documentos Word con agentes de codigo
• Open Agreements -- completar plantillas legales estandar con agentes de codigo

Agent Email se ejecuta completamente en tu maquina local. Las credenciales de correo se almacenan en el llavero de tu sistema operativo (MSAL) y en archivos de configuracion locales. Agent Email no envia contenido de correo a servidores externos.

• Guia de contribucion (en ingles)
• Codigo de conducta (en ingles)
• Politica de seguridad (en ingles)
• Registro de cambios (en ingles)