Servidor MCP de Google Calendar

Este proyecto implementa un Servidor Model Context Protocol (MCP) que permite a herramientas IA conectarse e interactuar con Google Calendar.

🚀 Inicio Rápido

1. Requisitos Previos

   • Node.js (v18+)

   • Un proyecto configurado en Google Cloud Console con la API de Google Calendar habilitada.

   • Archivo .env en la raíz con tus credenciales OAuth 2.0 (App de Escritorio):

     CLIENT_ID=tu_client_id
     CLIENT_SECRET=tu_client_secret

2. Instalación

   npm install

3. Autenticación (Primera vez) Para autorizar el acceso a tu calendario, ejecuta el script de autenticación local. Este levantará un servidor temporal en http://127.0.0.1:3000 para capturar el token de forma segura:

   npm run auth

   Nota: Asegúrate de añadir tu correo de Gmail a la lista de Usuarios de prueba (Test users) en la sección de Audiencia de Google Auth Platform en tu consola de Google Cloud.

4. Compilar y Ejecutar el Servidor Compila el código TypeScript a JavaScript nativo:

   npm run build

   Ejecuta el servidor compilado:

   npm start

5. Depuración y Testing Puedes inspeccionar visualmente y probar las herramientas del servidor en tu navegador usando el MCP Inspector oficial:

   npm run inspect

Related MCP server: Google Calendar MCP

🛠️ Herramientas Disponibles (Tools)

• list_events: Lista eventos de Google Calendar. Muestra la semana actual por defecto o un rango/día específico.

• create_event: Crea un nuevo evento en Google Calendar con título, fecha/hora de inicio y fin.

• find_free_slots: Busca ventanas de tiempo libres según la duración mínima requerida y una franja horaria laboral.

• reschedule_event: Reprograma o mueve un evento existente a un nuevo horario mediante su ID.

• delete_or_cancel_event: Elimina o cancela un evento del calendario usando su ID.

• detect_conflicts: Examina el calendario en busca de solapamientos entre actividades.

• get_workload_analytics: Generar métricas y desgloses de horas agendadas por categoría ([FREELANCE], [TRABAJO], [FORMACION], etc.).

⚙️ Integración con Antigravity

Añade este servidor a tu configuración de antigravity.json (o .gemini/config/mcp_config.json):

{
  "mcpServers": {
    "google-calendar": {
      "command": "node",
      "args": ["/ruta/absoluta/al/proyecto/dist/index.js"]
    }
  }
}

Acontinuacion se muestra un listado de las tools disponibles (o que lo estaran) y su finalidad. Tambien se incluye un pequeño resumen de las skills con las que yo compagino este MCP para potenciar su uso.

🔗 Enlaces Útiles

• Google Cloud Console

• Documentación Oficial de Google Calendar API

• Documentación del Protocolo MCP