Google Calendar

Un servidor MCP para crear y gestionar eventos de Google Calendar.

GitHub

Documentación

Servidor MCP de Google Calendar

Un servidor de Model Context Protocol (MCP) para crear eventos de Google Calendar.

Configuración

  1. Instalar dependencias:

    npm install

  2. Obtener credenciales de la API de Google Calendar:

    • Ve a Google Cloud Console
    • Crea un nuevo proyecto o selecciona uno existente
    • Habilita la API de Google Calendar
    • Crea credenciales (ID de cliente OAuth 2.0)
    • Descarga las credenciales y guárdalas como credentials.json en la raíz del proyecto

  3. Autenticación:

    • Ejecuta el servidor y usa la herramienta authenticate_google_calendar para obtener la URL de autenticación
    • Visita la URL, otorga permisos y obtén el código de autorización
    • Crea un archivo token.json con tus credenciales

  4. Configurar Claude Code: Agrega a tu configuración de MCP:

    {
  "mcpServers": {
    "google-calendar": {
      "command": "node",
      "args": ["/Users/krilet/mcp-google-calendar-server/src/index.js"]
    }
  }
}

Uso

El servidor proporciona dos herramientas:

authenticate_google_calendar

Genera una URL de autenticación para el acceso a Google Calendar.

create_calendar_event

Crea un nuevo evento en tu Google Calendar.

Parámetros:

  • summary (obligatorio): Título del evento
  • startDateTime (obligatorio): Hora de inicio en formato ISO
  • endDateTime (obligatorio): Hora de finalización en formato ISO
  • description (opcional): Descripción del evento
  • location (opcional): Ubicación del evento
  • timeZone (opcional): Zona horaria (por defecto UTC)
  • attendees (opcional): Matriz de direcciones de correo electrónico

Ejemplo:

{
  "summary": "Team Meeting",
  "startDateTime": "2024-12-25T10:00:00-08:00",
  "endDateTime": "2024-12-25T11:00:00-08:00",
  "description": "Weekly team sync",
  "location": "Conference Room A",
  "attendees": ["colleague@example.com"]
}