Conecta Gmail, Outlook o IMAP a Claude
en cuatro pasos.

Devuelve todas las bandejas a las que la clave API u OAuth actual tiene acceso. Llama a esta primero para descubrir los valores de inbox_id, así nunca copias UUID desde el panel. Cada resultado incluye la dirección de correo, el proveedor, una marca de servicio opcional (icloud/yahoo/zoho/yandex/generic/fastmail) y un objeto capabilities que describe qué funciones admite esa bandeja.

Lee, lista y busca mensajes en una bandeja. Define action: 'list' para resúmenes de mensajes recientes (más nuevos primero, con filtro por carpeta/no leídos y paginación), 'read' para el contenido completo de un message_id (cuerpo de texto, HTML saneado opcional y adjuntos), 'read_batch' para obtener hasta 50 message_ids en una sola llamada, 'search' para filtros estructurados e independientes del proveedor (from, to, cc, subject, body, text, unread, has_attachment, flagged, since, before), o 'attachment' para descargar un único adjunto (por attachment_index o filename) como datos base64, hasta 25 MB. Solo lectura: nunca cambia nada. La acción 'search' también se desbloquea por sí sola con el permiso más limitado search:email. Los cuerpos largos se devuelven por ventanas: revisa body_truncated y reenvía body_next_offset como body_offset para continuar. En Outlook, un criterio de texto (from, to, cc, subject, body, text o query) no se puede combinar con unread, has_attachment, flagged, since ni before: esos filtros no se aplican y el resultado indica cuáles.

Mueve, copia, marca o archiva mensajes que indicas por message_id. Define action: 'move'/'move_batch' (a un destination_folder_id), 'copy'/'copy_batch' (duplica en un destination_folder_id, dejando el original en su lugar; disponible allí donde inbox_list indique capabilities.copy true: todas las bandejas IMAP, incluida una dirección de Gmail conectada por IMAP, y Outlook), 'flag' (establece leído/no leído/destacado mediante flag_action sobre message_ids), o 'archive' (saca un mensaje de la bandeja de entrada). Obtén antes los IDs con email_read. Cada acción toca solo los IDs que pasas y se deshace con otra llamada: un movimiento con el movimiento inverso, archive con un movimiento a la bandeja de entrada, flag con la marca contraria, y una copia deja el original donde estaba. En Gmail, mover añade la etiqueta de destino y quita INBOX; las demás etiquetas se mantienen, sacar un mensaje de Trash o Spam también limpia TRASH/SPAM, así que es una restauración real, y el conector de la API de Gmail (provider 'gmail') no tiene copia nativa, aunque un buzón de Gmail conectado por IMAP copia como cualquier otra bandeja IMAP. Para mover todo lo que coincida con una búsqueda en lugar de una lista de IDs, usa email_search_and_move: es una herramienta aparte porque un solo filtro equivocado allí reubica una bandeja entera. Cada acción necesita manage:folders. Eliminar mensajes vive en su propia herramienta email_delete.

Mueve a una carpeta de destino cada mensaje que coincida con una búsqueda, en una sola operación del lado del servidor, de modo que ningún ID de mensaje quede obsoleto antes de usarse. La búsqueda usa los mismos campos estructurados e independientes del proveedor que email_read (from, to, cc, subject, body, text, unread, has_attachment, flagged, since, before), que el servidor traduce a la sintaxis nativa de la bandeja; query es un recurso de emergencia en crudo. Es una herramienta aparte de email_organize, y es la que se marca como destructiva ante tu cliente MCP, porque actúa sobre todo lo que encuentra el filtro y no sobre IDs que hayas elegido: un solo filtro equivocado reubica una bandeja entera. Para mover mensajes que ya has listado, usa email_organize (action 'move' o 'move_batch') en su lugar. Limitada por limit, por defecto y máximo 500: comprueba has_more en el resultado antes de dar una bandeja por barrida del todo, y termina el resto con email_organize (action 'move_batch'). En Gmail, mover añade la etiqueta de destino y quita INBOX. Devuelve los recuentos succeeded/failed y un resultado por mensaje. Necesita manage:folders.

Elimina mensajes. Es su propia herramienta, separada de email_organize, porque eliminar es destructivo. Define action: 'delete'/'delete_batch' (Papelera por defecto, o permanente), o 'search_and_delete' (elimina cada mensaje que coincida con una búsqueda estructurada, evita IDs de mensaje obsoletos). Las eliminaciones van a la Papelera salvo que pases permanent: true, que es irreversible. Cada acción necesita el permiso delete:email, y toda la herramienta se marca como destructiva ante tu cliente MCP, que gestiona la confirmación del usuario antes de eliminar nada.

Envía correo nuevo o responde a mensajes existentes. Define action: 'send' para un correo nuevo (to/subject/body, opcionalmente cc/bcc/html_body/reply_to/attachments), 'reply' para responder a un message_id (las cabeceras de hilo se establecen automáticamente; opcionalmente reply_all), o 'forward' para reenviar un message_id a nuevos destinatarios, retransmitiendo el original byte a byte (HTML, imágenes en línea y adjuntos intactos). La firma de la bandeja se añade automáticamente: en respuestas y reenvíos va después de tu texto y antes del bloque citado, regida por el modo de respuesta de la firma; pasa include_signature: false para suprimirla en un único mensaje escueto. Las tres son irreversibles una vez enviadas. 'forward' también acepta message_ids para hasta 50 mensajes en una llamada, informados uno a uno. Para adjuntar un archivo que ya está en esta bandeja, refiérelo como { source_message_id, attachment_index } en lugar de leerlo y volver a codificarlo.

Lista todas las carpetas de una bandeja, o todas las etiquetas en Gmail. Cada entrada incluye su ID nativo del proveedor, nombre visible, tipo ('folder' en los proveedores jerárquicos, 'label' en Gmail) y los recuentos de mensajes, totales y sin leer. Usa los IDs devueltos como argumento folder al listar correo con email_read y como destino de los movimientos de email_organize. Solo lectura, sin argumento action: lo único que hay que indicar es qué bandeja consultar. Necesita read:email.

Crea, renombra y elimina carpetas del buzón o etiquetas de Gmail. Los parámetros usan 'folder' por compatibilidad entre proveedores, pero Gmail gestiona etiquetas (type: 'label'), no carpetas. Define action: 'create' (name), 'rename' (folder_id, new_name) o 'delete' (folder_id, irreversible; en Gmail quita la etiqueta de todos los mensajes que la lleven, y en otros proveedores los mensajes que contenga pueden perderse). Leer las carpetas que existen es la herramienta aparte de solo lectura folder_list, que además es de donde salen los folder_id que toman estas acciones. Todas las acciones necesitan manage:folders, y la herramienta se marca como destructiva ante tu cliente MCP.

Devuelve los borradores guardados en la carpeta Drafts de la bandeja, cada uno con su draft_id, asunto, destinatarios y fecha de creación. Pasa el draft_id a la herramienta draft para actualizar, enviar o eliminar uno. Solo lectura, sin argumento action. Necesita manage:drafts.

Crea, actualiza, envía y elimina borradores sin enviar en la carpeta Drafts de la bandeja. Define action: 'create' (subject/body obligatorios, opcionalmente to/cc/bcc/html_body), 'reply' (message_id/body obligatorios, opcionalmente reply_all; crea una respuesta sin enviar en la conversación de origen), 'update' (draft_id más los campos a sobrescribir), 'send' (draft_id, elimina el borrador y lo envía, irreversible) o 'delete' (draft_id). Leer los borradores que existen es la herramienta aparte de solo lectura draft_list. La firma de la bandeja se incrusta cuando el borrador se crea o se actualiza, así que ya está presente en la carpeta Drafts y no se vuelve a añadir al enviar; pasa include_signature: false para crear un borrador sin ella. En bandejas basadas en IMAP un draft_id cambia en cada actualización, así que usa siempre el más reciente; Gmail y Outlook mantienen un draft_id estable. 'reply' necesita además read:email y nunca envía correo, 'send' necesita send:email para que una clave limitada a borradores no pueda usar un borrador para saltarse el consentimiento de envío, y el resto necesitan manage:drafts. Los borradores admiten adjuntos igual que email_compose: en base64, o un archivo que ya está en esta bandeja mediante source_message_id. 'update' añade archivos y conserva los que el borrador ya tiene.

Lista los envíos programados pendientes del espacio de trabajo, los más próximos primero, opcionalmente filtrados por una bandeja. Se devuelve todo lo que esté en estado 'pending' o 'sending'. Pasa el id devuelto a la herramienta schedule (action 'cancel') para detener un envío antes de que se despache. Solo lectura, sin argumento action. Necesita schedule:email.

Programa correo para entrega futura mediante una cola en el servidor, o cancela un envío ya encolado. Define action: 'create' (to/subject/body más una marca de tiempo send_at en ISO 8601 con zona horaria; los destinatarios y el cuerpo se validan de inmediato, y los envíos inválidos no se encolan) o 'cancel' (id, solo se pueden cancelar los envíos que sigan 'pending'). Leer lo que hay en cola es la herramienta aparte de solo lectura schedule_list, que además es de donde sale el id que toma 'cancel'. Usa email_compose para enviar ahora, y esta solo cuando se indique una hora posterior. El despachador se ejecuta cada minuto, por lo que la entrega puede ocurrir hasta 60 segundos después de send_at. Todas las acciones necesitan schedule:email.

Lee la firma configurada de una bandeja: su texto plano y su HTML, si está habilitada, el modo de respuesta/reenvío, su origen ('manual', 'gmail_import' o null cuando no hay ninguna) y sender_name, el nombre que los destinatarios ven en la cabecera From. La firma se añade del lado del servidor en cada envío, respuesta, reenvío, borrador y mensaje programado. Solo lectura, sin argumento action. Necesita read:email.

Escribe la firma de una bandeja, que se añade del lado del servidor en cada envío, respuesta, reenvío, borrador y mensaje programado. Pasa signature_text, signature_html o ambos, y opcionalmente signature_enabled, signature_reply_mode y sender_name; pasa una cadena vacía en ambos cuerpos para borrarla. Las firmas admiten HTML enriquecido: negrita, cursiva, encabezados, listas, colores, alineación, enlaces e imágenes/logotipos alojados referenciados como URLs https, de modo que un agente puede establecer una firma con formato completo pasando signature_html. El mismo editor enriquecido está disponible en el panel. Establecer una firma marca su origen como 'manual', lo que anula de forma permanente la importación automática de Gmail para esa bandeja. sender_name define el nombre que los destinatarios ven en la cabecera From, p. ej. "Acme Support", mostrado antes de la dirección misma, y puede establecerse por sí solo sin tocar la firma. Leer la firma actual es la herramienta aparte signature_get. No hay argumento action. Necesita send:email.

Inspecciona las reglas de triaje programadas y desatendidas y lo que han estado haciendo. Una regla es una búsqueda guardada más una acción fija, reevaluada con una cadencia fija y sin ningún modelo de por medio: el correo se compara, nunca se interpreta. Define action: 'list' (todas las reglas), 'get' (automation_id, una regla completa), 'runs' (contadores de las ejecuciones recientes de una regla) o 'preview' (una simulación que informa de lo que coincide con el filtro ahora mismo, no aplica nada, no envía nada y no reclama nada en el registro de deduplicación). Nada de esto cambia una regla ni toca el buzón; crear y modificar reglas es la herramienta aparte automation. Todas las acciones requieren manage:automations.

Crea, modifica, activa, desactiva y elimina reglas de triaje programadas y desatendidas. Una regla es una búsqueda guardada más una acción fija, reevaluada con una cadencia fija y sin ningún modelo de por medio: el correo se compara, nunca se interpreta. Define action: 'create' (name, filter, rule_action e interval_minutes; la regla siempre se crea desactivada), 'update' (automation_id más los campos a cambiar), 'enable', 'disable' o 'delete' (automation_id; se conserva el historial de ejecuciones). Listar reglas, leer una completa, ver el historial de ejecuciones y simular un filtro es la herramienta aparte de solo lectura automation_read. Las acciones de regla disponibles son move, label (una etiqueta de Gmail, una categoría de Outlook o una palabra clave IMAP), mark_read, forward y draft_reply. Eliminar correo no está disponible para una automatización. Un reenvío siempre queda retenido para su aprobación humana, diga lo que diga el ajuste de aprobación del buzón, y draft_reply solo escribe un borrador. Haz una previsualización antes de activarla. Todas las acciones requieren manage:automations.

Encuentra correspondientes por nombre o correo con un escaneo en vivo de tu buzón: no hay una lista de contactos almacenada. Cada llamada escanea una ventana reciente de correo coincidente y devuelve las personas que coinciden, ordenadas por contacto más reciente, cada una con nombre visible, correo, recuento de mensajes coincidentes y marca de tiempo del último contacto. Los recuentos reflejan los mensajes coincidentes en esa ventana, no todo tu historial, y nada se almacena entre llamadas.