Cómo conectar Gmail a Meta Muse vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Gmail, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Gmail + Meta Muse

Deja que tu IA trabaje en Gmail: busca en el buzón con la sintaxis de búsqueda de Gmail, lee mensajes y conversaciones, marca correos como leídos, archívalos, destácalos o etiquétalos, y escribe, responde y envía correos, o guarda un borrador para revisarlo antes. Gmail personal y Google Workspace, con tu propio cliente OAuth de Google.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Paso 1 — Obtener credenciales

1. Abre console.cloud.google.com, elige o crea un proyecto y ve a APIs & Services → Library para activar la Gmail API.
2. Abre APIs & Services → OAuth consent screen. Elige Internal si el buzón está en Google Workspace (la opción más sencilla); si no, External. Con External, pon el estado de publicación en In production: mientras la app está en Testing, Google revoca sus tokens de actualización a los 7 días y el conector deja de funcionar cada semana.
3. Abre APIs & Services → Credentials → Create credentials → OAuth client ID, elige el tipo de aplicación Web application y añade el URI de redirección autorizado https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback.
4. Pega el ID de cliente en GOOGLE_CLIENT_ID y el secreto de cliente en GOOGLE_CLIENT_SECRET e instala el conector.
5. En la página del conector, haz clic en Authorize with Provider e inicia sesión con la cuenta de Gmail con la que debe trabajar la IA. El token de actualización se guarda cifrado y los tokens de acceso se renuevan automáticamente.
6. Pide a la IA que ejecute gmail_get_profile: devuelve la dirección con la que trabaja el conector y cuántos mensajes y conversaciones tiene el buzón.

Un solo cliente de Google para todos los conectores de Google: el mismo proyecto de Cloud y el mismo cliente OAuth sirven para todos los conectores de Google: Gmail, Google Calendar, Google Drive, Google Sheets, Google Docs, Google Tasks, Search Console, Analytics y Ads. Activa cada API en ese proyecto, reutiliza el mismo ID y secreto de cliente y autoriza cada conector una vez. Cada uno pide solo sus propios permisos.

Verificación de Google: Google clasifica los permisos de Gmail que usa este conector (gmail.modify, y gmail.readonly para una configuración de solo lectura) como restringidos (restricted). Una app Internal, que solo usan cuentas de la organización de Workspace dueña del proyecto de Cloud, no necesita verificación: para una empresa es el camino directo. Una app External que usan otras personas muestra el aviso "Google hasn't verified this app" y está limitada a 100 usuarios hasta que supera la verificación de Google, que para permisos restringidos incluye una evaluación de seguridad. Para una sola cuenta personal de Gmail, una app External In production que solo usas tú funciona tras continuar después del aviso.

Permisos: el conector pide https://www.googleapis.com/auth/gmail.modify: leer el correo, cambiar etiquetas (marcar como leído, archivar, destacar), crear borradores y enviar correos. Trabaja como la cuenta de Google que lo autorizó y ve exactamente lo que ve esa cuenta. No puede eliminar nada de forma definitiva.

Qué envía correos de verdad: gmail_send_message (un correo nuevo), gmail_reply (una respuesta dentro de una conversación) y gmail_send_draft (un borrador existente, tal como está escrito) envían al momento desde la dirección conectada, y el envío no se puede deshacer. gmail_create_draft solo guarda un borrador, también como respuesta en una conversación, que revisas y envías tú desde Gmail; el conector indica a la IA que prefiera un borrador cuando no has pedido claramente enviar. Un mensaje llega como máximo a 500 destinatarios. Un correo que lee la IA podría contener un texto que le pida enviar algo: si la IA solo debe preparar correos, desactiva gmail_send_message, gmail_reply y gmail_send_draft y envía tú los borradores.

Solo lectura: cambia el scope en los ajustes OAuth del conector a https://www.googleapis.com/auth/gmail.readonly, vuelve a autorizar y desactiva gmail_modify_message_labels, gmail_modify_thread_labels, gmail_create_draft, gmail_send_draft, gmail_send_message y gmail_reply.

Leer y ordenar el correo: las búsquedas usan la misma sintaxis que el cuadro de búsqueda de Gmail, por ejemplo from:[email protected] is:unread newer_than:7d o has:attachment. Los mensajes y las conversaciones llegan como texto sin formato (los correos solo HTML se convierten); un texto muy largo se corta a los 20.000 caracteres, o a los 100.000 en una conversación entera. Los adjuntos se listan con nombre, tipo y tamaño, pero no se descargan. Marcar como leído, archivar, destacar y clasificar con una etiqueta son cambios de etiquetas en un mensaje o en una conversación entera.

Límites de uso: Gmail permite 6.000 unidades de cuota por minuto y usuario. Una búsqueda cuesta 5, leer un mensaje 20, una conversación 40, y enviar un mensaje o un borrador 100. Por encima del límite Gmail responde 429 (o 403 userRateLimitExceeded): espera un minuto y vuelve a intentarlo.

Errores frecuentes: 401 significa que la autorización caducó o se revocó (siempre a los 7 días mientras la pantalla de consentimiento está en Testing): vuelve a hacer clic en Authorize with Provider. 403 accessNotConfigured significa que la Gmail API no está activada en el proyecto de Cloud. 403 insufficientPermissions o ACCESS_TOKEN_SCOPE_INSUFFICIENT significa que el scope no permite la llamada, por ejemplo un cambio de etiquetas en una configuración de solo lectura. 404 significa que el id no existe en este buzón; un id de borrador (empieza por r-) no es un id de mensaje. 400 invalidArgument suele indicar un id de etiqueta que no existe: las etiquetas propias tienen ids como Label_12, que devuelve gmail_list_labels.

El conector no envía ni descarga adjuntos, no reenvía correos con sus adjuntos originales, no mueve nada a la papelera ni elimina, y no gestiona filtros, ajustes, alias de envío ni buzones de otras personas.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Muse

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.

1. En Muse, abre Settings → Connectors y elige Add custom connector.
2. Pega la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
4. En un chat, pídele a Muse algo que necesite las herramientas de Gmail.

También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué correos sin leer de los últimos 3 días siguen esperando una respuesta mía? Resume cada uno en una frase."
• "Busca el último correo de [email protected] sobre la oferta y prepara un borrador de respuesta que acepte la nueva fecha. No lo envíes, lo reviso yo en Gmail."
• "Archiva y marca como leídos todos los boletines de mi bandeja de entrada de hace más de una semana, y luego dime qué archivaste."
• "Lista todos los correos con adjuntos desde el 1 de octubre que parezcan facturas, con remitente, fecha, asunto y nombre del archivo."

FAQ

¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.

¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini