Ir a la documentación
CLI

IA y MCP

Traducir, redactar y resumir correo, conectar clientes de IA a tu buzón, llamar a herramientas MCP y preguntar a la documentación.

Comandos de IA

ComandoQué haceInicio de sesión
ai translateTraducir un asunto y un cuerpo sin enviar nadaCualquiera de los dos, con emails:send
ai languagesListar cada idioma que acepta la traducciónCualquiera, o ninguno: sin sesión muestra la tabla incluida en la CLI
ai compose "<prompt>"Redactar el cuerpo de un correo con tu propio estiloUn inicio de sesión con el navegador
ai summarize <thread-id>Mostrar el resumen que OpenEmail guarda de un hiloUn inicio de sesión con el navegador

translate y compose gastan cada uno una acción de IA de la asignación diaria del espacio de trabajo, y una asignación agotada se detiene con el código de salida 8. compose y summarize pasan por las herramientas MCP composeEmail y getThreadSummary, por eso necesitan un inicio de sesión con el navegador: una clave de API no puede llegar al servidor MCP.

Traducir

Terminal
openemail ai translate --to de --subject "Your invoice" --text "The invoice is attached."openemail ai translate --to Japanese --body-file reply.html --no-originalcat notes.txt | openemail ai translate --to fropenemail ai languages --search port

Ejecuta la traducción que haría un envío traducido y muestra el resultado, para que lo leas antes de que salga nada. No se guarda ni se envía nada. --to admite un código, un nombre en inglés o el nombre propio del idioma. El cuerpo sale de --text, --html, --body-file o stdin, y --text y --html también leen un archivo con @path.

  • Tu texto original se conserva debajo de la traducción, salvo que pases --no-original.
  • El idioma de origen detectado se muestra en stderr, y --json muestra la traducción completa.
  • Para traducir al enviar, usa openemail send --translate de.

Redactar y resumir

Terminal
openemail ai compose "thank Ada for the invoice and ask for a PDF copy" --to [email protected]openemail ai compose "say yes to Tuesday at 3pm" --thread CAHk7pQ2x9LmZ4 --tone friendlyopenemail ai compose "decline politely" --thread CAHk7pQ2x9LmZ4 | openemail send --to [email protected] --subject "Re: Proposal"openemail ai summarize CAHk7pQ2x9LmZ4
  • compose muestra un cuerpo redactado con tu estilo y no envía nada, así que pásalo a openemail send cuando te guste. Con --thread lee primero los últimos mensajes del hilo y redacta una respuesta. --tone es uno de formal, friendly, casual, concise, direct o warm.
  • summarize muestra el resumen con el asunto, el remitente y la fecha. Los resúmenes se escriben cuando llega el correo, y un hilo que contiene un mensaje cifrado no tiene ninguno, lo que sale con el código 5.

Conectar un cliente de IA

El servidor MCP de OpenEmail da a un cliente de IA las herramientas que usa el asistente de la app: puede leer y enviar correo y gestionar contactos, plantillas, dominios y más, limitado a lo que apruebes. Un cliente se conecta de una de dos formas, y openemail mcp config muestra ambas para tu cliente:

  • El servidor remoto. El cliente hace su propio inicio de sesión con el navegador, lo apruebas en la página de consentimiento de OpenEmail y aparece en Cuenta → Aplicaciones conectadas. Es la opción más sencilla cuando el cliente la admite.
  • El puente local, openemail mcp serve, que el cliente arranca mediante npx. Usa el inicio de sesión de esta CLI, así que ejecuta primero openemail login. Va bien con clientes que solo arrancan servidores locales.
Terminal
openemail mcp configopenemail mcp config --client claude-codeopenemail mcp config --client cursor --profile workopenemail mcp config --client vscode --json
claude mcp add --transport http openemail https://api.openemail.uk/mcp
claude mcp add openemail -- npx -y @openemail/cli mcp serve

Después de añadir el servidor remoto, Claude Code inicia sesión desde /mcp y Codex con codex mcp login openemail. Claude Desktop lo añade en Settings → Connectors → Add custom connector. openemail mcp config --client <name> también dice qué archivo lee cada cliente.

El puente local

openemail mcp serve lee JSON-RPC delimitado por saltos de línea en stdin, reenvía cada mensaje al servidor MCP con tu inicio de sesión con el navegador guardado y escribe cada respuesta en stdout como una línea. Renueva un token de acceso caducado sin que el cliente lo note, responde a un lote como un único array y se detiene cuando stdin se cierra. Solo el protocolo llega a stdout, y stderr se mantiene en silencio salvo que pases --debug.

Terminal
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | openemail mcp serveopenemail mcp serve --profile workopenemail mcp serve --debug 2> mcp.log

El puente no puede pedir un código de verificación por stdio. Una herramienta que lo necesita llega al cliente como un rechazo, y el puente muestra una sola pista en stderr. Ejecuta openemail verify en un terminal con el mismo perfil, y esas herramientas funcionan durante los 60 minutos siguientes.

Llamar a herramientas tú mismo

Terminal
openemail mcp toolsopenemail mcp tools composeEmailopenemail mcp call whoAmIopenemail mcp call listThreads --arg folder=inbox --arg maxResults=5openemail mcp call getThread --args '{"threadId":"CAHk7pQ2x9LmZ4"}'
  • mcp tools lista las herramientas que puede usar este inicio de sesión, que ya excluye las que tu rol o la aprobación no permiten. Nombra una herramienta para ver su descripción y sus argumentos.
  • mcp call recibe los argumentos como un objeto JSON en --args (en línea, @file o -), y --arg key=value fija uno cada vez. Un valor se lee como JSON cuando se puede analizar, así que pon entre comillas un número que quieras como texto.
  • El servidor MCP nunca pide confirmación, así que una herramienta que envía o elimina actúa al momento.
  • Un resultado que empieza por Refused ( sale con el código 4. Una herramienta desconocida sale con 5, unos argumentos no válidos con 7, y una asignación de IA agotada con 8.

Seis herramientas hacen un cambio que la API REST protege con un código de verificación, y piden el mismo código: createRule, setRuleEnabled, removeDomain, removeDomainAddress, deleteAudience para una audiencia que creaste, y emptyAudience para una audiencia que creaste y que aún tiene contactos. En un terminal, mcp call pide el código y vuelve a llamar a la herramienta. Sin supervisión sale con el código 4, así que ejecuta primero openemail verify.

Preguntar a la documentación

Terminal
openemail docs ask "how do I verify a domain?"openemail docs open cli/authenticationopenemail docs read cli/commandsopenemail docs read
  • docs ask hace una pregunta al asistente de la documentación y muestra la respuesta a medida que se escribe, y luego las páginas de las que salió. Responde solo a partir de esta documentación, no necesita iniciar sesión y nunca envía tus credenciales. Una pregunta puede tener hasta 600 caracteres, y cada red puede hacer un número limitado al día.
  • docs open abre una página en tu navegador, y --print muestra su enlace en su lugar.
  • docs read muestra una página en Markdown. Sin página, muestra el índice de todas las páginas.

Tu bandeja de entrada,
en tus propios términos.

Infraestructura de correo para empresas, IA, agentes y correo personal. Creada para escalar, con privacidad y control. Todo lo que el correo debería haber tenido desde el primer día.

OpenEmail

Infraestructura de correo para empresas, IA, agentes y correo personal. Creada para escalar, con privacidad y control. Todo lo que el correo debería haber tenido desde el primer día.

© 2026 OpenEmail. Todos los derechos reservados.