Cómo conectar Gmail a Gemini 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 + Gemini

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Gmail.

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 busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

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