@pablosr/mcp-google-calendar 1.1.0 → 1.1.2

package/dist/index.js

@@ -6,7 +6,7 @@ import { GoogleCalendarClient } from "./tools/google-calendar-client.js";
 import { registerGoogleCalendarTools } from "./tools/google-calendar-mcp.js";
 const server = new McpServer({
     name: "mcp-google-calendar",
-    version: "1.1.0",
+    version: "1.1.2",
 });
 async function main() {
     console.error('Configurando Google Calendar API...');

package/dist/tools/calendar/calendar-create-event.js

@@ -4,12 +4,12 @@ export function registerGoogleCreateEvent(googleClient, server) {
     server.tool('calendar_create_event', 'Crea un nuevo evento en Google Calendar', {
         calendarId: z.string().optional().describe('ID del calendario (por defecto: primary)'),
         title: z.string().describe('Título del evento'),
-        start: z.string().describe('Fecha/hora de inicio en formato ISO (ej: 2023-12-01T10:00:00Z)'),
-        end: z.string().describe('Fecha/hora de fin en formato ISO'),
+        start: z.string().describe('Fecha/hora de inicio en formato ISO 8601 Zulu time (ej: 2023-12-01T10:00:00Z).'),
+        end: z.string().describe('Fecha/hora de fin en formato ISO 8601 Zulu time (ej: 2023-12-01T11:00:00Z).'),
         description: z.string().optional().describe('Descripción del evento (opcional)'),
         location: z.string().optional().describe('Ubicación del evento (opcional)'),
         attendees: z.array(z.string().email()).optional().describe('Lista de emails de los invitados (opcional)'),
-        timeZone: z.string().optional().describe('Zona horaria en formato IANA (ej: America/New_York, Atlantic/Canary). Por defecto usa DEFAULT_TIMEZONE del .env'),
+        timeZone: z.string().optional().describe('Zona horaria en formato IANA (ej: America/New_York, Atlantic/Canary). Por defecto usa DEFAULT_TIMEZONE del .env. Esta zona se usa para interpretar la hora Zulu en el calendario'),
     }, async (args) => {
         try {
             const { calendarId = 'primary', title, start, end, description, location, attendees, timeZone, } = args;

package/dist/tools/calendar/calendar-list-events.js

@@ -1,14 +1,17 @@
 import { z } from 'zod';
+import { validateAndNormalizeDate } from '../utils/date-validation.js';
 export function registerGoogleListEvents(googleClient, server) {
     server.tool('calendar_list_events', 'Lista eventos de un calendario de Google Calendar', {
         calendarId: z.string().optional().describe('ID del calendario (por defecto: primary)'),
-        timeMin: z.string().optional().describe('Fecha/hora mínima en formato ISO (ej: 2023-12-01T00:00:00Z)'),
-        timeMax: z.string().optional().describe('Fecha/hora máxima en formato ISO'),
+        timeMin: z.string().optional().describe('Fecha/hora mínima en formato ISO 8601 Zulu time (ej: 2023-12-01T00:00:00Z).'),
+        timeMax: z.string().optional().describe('Fecha/hora máxima en formato ISO 8601 Zulu time (ej: 2023-12-31T23:59:59Z).'),
         maxResults: z.number().optional().describe('Número máximo de resultados (por defecto: 10)'),
     }, async (args) => {
         try {
             const { calendarId = 'primary', timeMin, timeMax, maxResults = 10, } = args;
-            const events = await googleClient.listEvents(calendarId, timeMin, timeMax, maxResults);
+            const normalizedTimeMin = timeMin ? validateAndNormalizeDate(timeMin) : undefined;
+            const normalizedTimeMax = timeMax ? validateAndNormalizeDate(timeMax) : undefined;
+            const events = await googleClient.listEvents(calendarId, normalizedTimeMin, normalizedTimeMax, maxResults);
             const data = events.map((event) => ({
                 id: event.id,
                 summary: event.summary,

package/dist/tools/calendar/calendar-update-event.js

@@ -1,15 +1,16 @@
 import { z } from 'zod';
+import { validateAndNormalizeDate } from '../utils/date-validation.js';
 export function registerGoogleUpdateEvent(googleClient, server) {
     server.tool('calendar_update_event', 'Actualiza un evento existente en Google Calendar', {
         calendarId: z.string().optional().describe('ID del calendario (por defecto: primary)'),
         eventId: z.string().describe('ID del evento a actualizar'),
         title: z.string().optional().describe('Nuevo título del evento'),
-        start: z.string().optional().describe('Nueva fecha/hora de inicio en formato ISO (ej: 2023-12-01T10:00:00Z)'),
-        end: z.string().optional().describe('Nueva fecha/hora de fin en formato ISO'),
+        start: z.string().optional().describe('Nueva fecha/hora de inicio en formato ISO 8601 Zulu time (ej: 2023-12-01T10:00:00Z).'),
+        end: z.string().optional().describe('Nueva fecha/hora de fin en formato ISO 8601 Zulu time (ej: 2023-12-01T11:00:00Z).'),
         description: z.string().optional().describe('Nueva descripción del evento'),
         location: z.string().optional().describe('Nueva ubicación del evento'),
         attendees: z.array(z.string().email()).optional().describe('Lista de emails de los invitados (opcional)'),
-        timeZone: z.string().optional().describe('Zona horaria en formato IANA (ej: America/New_York, Atlantic/Canary). Por defecto usa DEFAULT_TIMEZONE del .env'),
+        timeZone: z.string().optional().describe('Zona horaria en formato IANA (ej: America/New_York, Atlantic/Canary). Por defecto usa DEFAULT_TIMEZONE del .env. Esta zona se usa para interpretar la hora Zulu en el calendario'),
     }, async (args) => {
         try {
             const { calendarId = 'primary', eventId, title, start, end, description, location, attendees, timeZone, } = args;
@@ -37,14 +38,16 @@ export function registerGoogleUpdateEvent(googleClient, server) {
             }
             const defaultTimeZone = timeZone || process.env.DEFAULT_TIMEZONE || 'Atlantic/Canary';
             if (start !== undefined) {
+                const normalizedStart = validateAndNormalizeDate(start);
                 event.start = {
-                    dateTime: start,
+                    dateTime: normalizedStart,
                     timeZone: defaultTimeZone,
                 };
             }
             if (end !== undefined) {
+                const normalizedEnd = validateAndNormalizeDate(end);
                 event.end = {
-                    dateTime: end,
+                    dateTime: normalizedEnd,
                     timeZone: defaultTimeZone,
                 };
             }

package/dist/tools/google-calendar-client.js

@@ -1,4 +1,5 @@
 import { google } from 'googleapis';
+import { validateAndNormalizeDate } from './utils/date-validation.js';
 export class GoogleCalendarClient {
     auth;
     calendar;
@@ -89,7 +90,7 @@ export class GoogleCalendarClient {
      */
     async updateEvent(calendarId = 'primary', eventId, event) {
         try {
-            const response = await this.calendar.events.update({
+            const response = await this.calendar.events.patch({
                 calendarId,
                 eventId,
                 requestBody: event,
@@ -237,19 +238,22 @@ export class GoogleCalendarClient {
 }
 /**
  * Función helper para crear eventos con formato simplificado
+ * Las fechas se normalizan a formato Zulu time (ISO 8601 UTC sin offset)
  */
 export function createSimpleEvent(title, start, end, description, location, attendees, timeZone) {
     const defaultTimeZone = timeZone || process.env.DEFAULT_TIMEZONE || 'Atlantic/Canary';
+    const normalizedStart = validateAndNormalizeDate(start);
+    const normalizedEnd = validateAndNormalizeDate(end);
     const event = {
         summary: title,
         description,
         location,
         start: {
-            dateTime: start,
+            dateTime: normalizedStart,
             timeZone: defaultTimeZone,
         },
         end: {
-            dateTime: end,
+            dateTime: normalizedEnd,
             timeZone: defaultTimeZone,
         },
     };

package/dist/tools/utils/date-validation.js

@@ -0,0 +1,45 @@
+/**
+ * Valida si una fecha está en formato ISO 8601 Zulu time (sin offset)
+ * Formato esperado: YYYY-MM-DDTHH:mm:ss.sssZ o YYYY-MM-DDTHH:mm:ssZ
+ * @param dateString - String de fecha a validar
+ * @returns true si está en formato Zulu time, false en caso contrario
+ */
+export function isZuluTime(dateString) {
+    const zuluTimeRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/;
+    return zuluTimeRegex.test(dateString);
+}
+/**
+ * Convierte cualquier fecha ISO 8601 a Zulu time (UTC sin offset)
+ * Si la fecha ya está en Zulu time, la devuelve sin cambios
+ * Si la fecha tiene offset, lo elimina y convierte a UTC
+ * @param dateString - String de fecha en formato ISO 8601
+ * @returns String de fecha en formato Zulu time
+ * @throws Error si la fecha no es válida
+ */
+export function convertToZuluTime(dateString) {
+    if (isZuluTime(dateString)) {
+        return dateString;
+    }
+    try {
+        const date = new Date(dateString);
+        if (isNaN(date.getTime())) {
+            throw new Error(`Fecha inválida: ${dateString}`);
+        }
+        return date.toISOString();
+    }
+    catch (error) {
+        throw new Error(`Error al convertir fecha a Zulu time: ${dateString}. ${error instanceof Error ? error.message : 'Error desconocido'}`);
+    }
+}
+/**
+ * Valida y normaliza una fecha a formato Zulu time
+ * @param dateString - String de fecha a validar y normalizar
+ * @returns String de fecha en formato Zulu time
+ * @throws Error si la fecha no es válida
+ */
+export function validateAndNormalizeDate(dateString) {
+    if (!dateString || typeof dateString !== 'string') {
+        throw new Error('La fecha debe ser un string no vacío');
+    }
+    return convertToZuluTime(dateString);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pablosr/mcp-google-calendar",
   "description": "A Google Calendar (MCP) server to expose calendar operations as tools for LLM.",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "main": "dist/index.js",
   "type": "module",
   "bin": "dist/index.js",