Conectar Gmail MCP con Microsoft Copilot

💡 ¿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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Gmail.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, 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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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