Cómo conectar Google Calendar a Gemini vía MCP

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

Google Calendar + Gemini

Deja que tu IA trabaje con Google Calendar: ve tus calendarios, lista y busca eventos en cualquier periodo, lee los detalles y los invitados, crea y reprograma reuniones con invitados y enlaces de Google Meet, responde a invitaciones, añade eventos a partir de una frase y comprueba cuándo están libres los demás. Cuentas personales de Google y Google Workspace.

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 Google Calendar API.
2. Abre APIs & Services → OAuth consent screen. Elige Internal si usas 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. Para tu propia cuenta puedes continuar sin más tras el aviso "unverified app".
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 Google cuyos calendarios debe usar la IA. El token de actualización se guarda cifrado y los tokens de acceso se renuevan automáticamente.

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.

Invitaciones y disponibilidad: los invitados reciben un correo solo si la IA pide a Google que los avise; si no, el evento aparece igualmente en sus calendarios. La disponibilidad de un compañero solo se ve si es visible para ti, lo habitual dentro de la misma organización de Google Workspace.

Permisos: el conector pide https://www.googleapis.com/auth/calendar.events (crear, cambiar y eliminar eventos en cada calendario que puedes editar) y https://www.googleapis.com/auth/calendar.readonly (leer la lista de calendarios, los calendarios, los colores y la disponibilidad). No puede crear ni eliminar calendarios ni cambiar con quién se comparten.

Solo lectura: cambia el scope en los ajustes OAuth del conector a https://www.googleapis.com/auth/calendar.readonly, vuelve a autorizar y desactiva gcal_create_event, gcal_update_event, gcal_respond_to_event y gcal_quick_add.

Desactivadas al instalar: gcal_delete_event. Actívala solo si la IA debe eliminar eventos.

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 Google Calendar API no está activada en el proyecto de Cloud. 403 insufficientPermissions significa que el scope no permite la llamada (un cambio en una configuración de solo lectura) o que solo puedes ver ese calendario. 404 significa que el calendario o el evento no existe o no es visible para esta cuenta.

El conector no crea, elimina ni comparte calendarios y no gestiona archivos adjuntos de eventos, ajustes del calendario ni notificaciones push.

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 Google Calendar.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué tengo en el calendario el resto de la semana? Señala las reuniones que se solapan."
• "Busca 45 minutos libres con [email protected] el martes o el miércoles por la mañana de la semana que viene y envíale una invitación con enlace de Google Meet."
• "Mueve la revisión de mañana a las 15:00 al viernes a la misma hora y avisa a los invitados."
• "Acepta la invitación a la reunión de planificación del jueves y rechaza la que coincide con ella."

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