---
title: Google Calendar
description: Gestionar eventos de Google Calendar
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="google_calendar"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Google Calendar](https://calendar.google.com) es el potente servicio de calendario y programación de Google que proporciona una plataforma completa para gestionar eventos, reuniones y citas. Con una integración perfecta en todo el ecosistema de Google y una adopción generalizada, Google Calendar ofrece funciones robustas tanto para necesidades de programación personales como profesionales.

Con Google Calendar, puedes:

- **Crear y gestionar eventos**: Programar reuniones, citas y recordatorios con información detallada
- **Enviar invitaciones de calendario**: Notificar y coordinar automáticamente con los asistentes mediante invitaciones por correo electrónico
- **Creación de eventos con lenguaje natural**: Añadir eventos rápidamente usando lenguaje conversacional como "Reunión con Juan mañana a las 3pm"
- **Ver y buscar eventos**: Encontrar y acceder fácilmente a tus eventos programados en múltiples calendarios
- **Gestionar múltiples calendarios**: Organizar diferentes tipos de eventos en varios calendarios

En Sim, la integración con Google Calendar permite a tus agentes crear, leer y gestionar eventos de calendario de forma programática. Esto permite potentes escenarios de automatización como programar reuniones, enviar invitaciones de calendario, comprobar disponibilidad y gestionar detalles de eventos. Tus agentes pueden crear eventos con entrada en lenguaje natural, enviar invitaciones de calendario automatizadas a los asistentes, recuperar información de eventos y listar próximos eventos. Esta integración cierra la brecha entre tus flujos de trabajo de IA y la gestión de calendarios, permitiendo una automatización de programación y coordinación perfecta con una de las plataformas de calendario más utilizadas del mundo.
{/* MANUAL-CONTENT-END */}

## Instrucciones de uso

Integra Google Calendar en el flujo de trabajo. Puede crear, leer, actualizar y listar eventos del calendario. Requiere OAuth.

## Herramientas

### `google_calendar_create`

Crear un nuevo evento en Google Calendar

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | No | ID del calendario \(por defecto es el primario\) |
| `summary` | string | Sí | Título/resumen del evento |
| `description` | string | No | Descripción del evento |
| `location` | string | No | Ubicación del evento |
| `startDateTime` | string | Sí | Fecha y hora de inicio. DEBE incluir el desplazamiento de zona horaria \(p. ej., 2025-06-03T10:00:00-08:00\) O proporcionar el parámetro timeZone |
| `endDateTime` | string | Sí | Fecha y hora de finalización. DEBE incluir el desplazamiento de zona horaria \(p. ej., 2025-06-03T11:00:00-08:00\) O proporcionar el parámetro timeZone |
| `timeZone` | string | No | Zona horaria \(p. ej., America/Los_Angeles\). Obligatorio si la fecha y hora no incluye desplazamiento. Por defecto es America/Los_Angeles si no se proporciona. |
| `attendees` | array | No | Array de direcciones de correo electrónico de los asistentes |
| `sendUpdates` | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de confirmación de creación del evento |
| `metadata` | json | Metadatos del evento creado incluyendo ID, estado y detalles |

### `google_calendar_list`

Listar eventos de Google Calendar

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | No | ID del calendario \(por defecto es el primario\) |
| `timeMin` | string | No | Límite inferior para eventos \(marca de tiempo RFC3339, p. ej., 2025-06-03T00:00:00Z\) |
| `timeMax` | string | No | Límite superior para eventos \(marca de tiempo RFC3339, p. ej., 2025-06-04T00:00:00Z\) |
| `orderBy` | string | No | Orden de los eventos devueltos \(startTime o updated\) |
| `showDeleted` | boolean | No | Incluir eventos eliminados |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Resumen del recuento de eventos encontrados |
| `metadata` | json | Lista de eventos con tokens de paginación y detalles del evento |

### `google_calendar_get`

Obtener un evento específico de Google Calendar

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | No | ID del calendario (predeterminado: primario) |
| `eventId` | string | Sí | ID del evento a recuperar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de confirmación de recuperación del evento |
| `metadata` | json | Detalles del evento incluyendo ID, estado, horarios y asistentes |

### `google_calendar_quick_add`

Crear eventos a partir de texto en lenguaje natural

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | No | ID del calendario (predeterminado: primario) |
| `text` | string | Sí | Texto en lenguaje natural que describe el evento (p. ej., "Reunión con Juan mañana a las 3pm") |
| `attendees` | array | No | Array de direcciones de correo electrónico de los asistentes (también se acepta cadena separada por comas) |
| `sendUpdates` | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de confirmación de creación del evento a partir de lenguaje natural |
| `metadata` | json | Metadatos del evento creado incluyendo detalles analizados |

### `google_calendar_invite`

Invitar asistentes a un evento existente de Google Calendar

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `calendarId` | string | No | ID del calendario \(por defecto es el primario\) |
| `eventId` | string | Sí | ID del evento al que invitar asistentes |
| `attendees` | array | Sí | Array de direcciones de correo electrónico de los asistentes a invitar |
| `sendUpdates` | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly, o none |
| `replaceExisting` | boolean | No | Si reemplazar a los asistentes existentes o añadirlos \(por defecto es false\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `content` | string | Mensaje de confirmación de invitación a asistentes con estado de entrega de correo electrónico |
| `metadata` | json | Metadatos actualizados del evento incluyendo lista de asistentes y detalles |

## Notas

- Categoría: `tools`
- Tipo: `google_calendar`

Mover un evento a un calendario diferente. Devuelve solo campos alineados con la API.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ------------ | ----------- |
| `calendarId` | string | No | ID del calendario de Google de origen \(p. ej., primary o calendar@group.calendar.google.com\) |
| `eventId` | string | Sí | ID del evento de Google Calendar a mover |
| `destinationCalendarId` | string | Sí | ID del calendario de Google de destino |
| `sendUpdates` | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `id` | string | ID del evento |
| `htmlLink` | string | Enlace del evento |
| `status` | string | Estado del evento |
| `summary` | string | Título del evento |
| `description` | string | Descripción del evento |
| `location` | string | Ubicación del evento |
| `start` | json | Inicio del evento |
| `end` | json | Fin del evento |
| `attendees` | json | Asistentes del evento |
| `creator` | json | Creador del evento |
| `organizer` | json | Organizador del evento |

### `google_calendar_instances`

Obtener instancias de un evento recurrente de Google Calendar. Devuelve solo campos alineados con la API.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ------------ | ----------- |
| `calendarId` | string | No | ID del calendario de Google \(p. ej., primary o calendar@group.calendar.google.com\) |
| `eventId` | string | Sí | ID del evento recurrente del que obtener instancias |
| `timeMin` | string | No | Límite inferior para las instancias \(marca de tiempo RFC3339, p. ej., 2025-06-03T00:00:00Z\) |
| `timeMax` | string | No | Límite superior para las instancias \(marca de tiempo RFC3339, p. ej., 2025-06-04T00:00:00Z\) |
| `maxResults` | number | No | Número máximo de instancias a devolver \(por defecto 250, máximo 2500\) |
| `pageToken` | string | No | Token para recuperar páginas posteriores de resultados |
| `showDeleted` | boolean | No | Incluir instancias eliminadas |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `nextPageToken` | string | Token de página siguiente |
| `timeZone` | string | Zona horaria del calendario |
| `instances` | json | Lista de instancias de eventos recurrentes |

### `google_calendar_list_calendars`

Listar todos los calendarios del usuario

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `minAccessRole` | string | No | Rol de acceso mínimo para los calendarios devueltos: freeBusyReader, reader, writer u owner |
| `maxResults` | number | No | Número máximo de calendarios a devolver \(predeterminado 100, máximo 250\) |
| `pageToken` | string | No | Token para recuperar páginas posteriores de resultados |
| `showDeleted` | boolean | No | Incluir calendarios eliminados |
| `showHidden` | boolean | No | Incluir calendarios ocultos |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `nextPageToken` | string | Token de página siguiente |
| `calendars` | array | Lista de calendarios |
|   ↳ `id` | string | ID del calendario |
|   ↳ `summary` | string | Título del calendario |
|   ↳ `description` | string | Descripción del calendario |
|   ↳ `location` | string | Ubicación del calendario |
|   ↳ `timeZone` | string | Zona horaria del calendario |
|   ↳ `accessRole` | string | Rol de acceso para el calendario |
|   ↳ `backgroundColor` | string | Color de fondo del calendario |
|   ↳ `foregroundColor` | string | Color de primer plano del calendario |
|   ↳ `primary` | boolean | Si este es el calendario principal |
|   ↳ `hidden` | boolean | Si el calendario está oculto |
|   ↳ `selected` | boolean | Si el calendario está seleccionado |

### `google_calendar_quick_add`

Crear eventos a partir de texto en lenguaje natural. Devuelve solo campos alineados con la API.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `calendarId` | string | No | ID del calendario de Google \(p. ej., primary o calendar@group.calendar.google.com\) |
| `text` | string | Sí | Texto en lenguaje natural que describe el evento \(p. ej., "Reunión con John mañana a las 3pm"\) |
| `attendees` | array | No | Array de direcciones de correo electrónico de los asistentes \(también se acepta cadena separada por comas\) |
| `sendUpdates` | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `id` | string | ID del evento |
| `htmlLink` | string | Enlace del evento |
| `status` | string | Estado del evento |
| `summary` | string | Título del evento |
| `description` | string | Descripción del evento |
| `location` | string | Ubicación del evento |
| `start` | json | Inicio del evento |
| `end` | json | Fin del evento |
| `attendees` | json | Asistentes del evento |
| `creator` | json | Creador del evento |
| `organizer` | json | Organizador del evento |

### `google_calendar_invite`

Invitar asistentes a un evento existente de Google Calendar. Devuelve solo campos alineados con la API.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `calendarId` | string | No | ID del calendario de Google \(p. ej., primary o calendar@group.calendar.google.com\) |
| `eventId` | string | Sí | ID del evento de Google Calendar al que invitar asistentes |
| `attendees` | array | Sí | Array de direcciones de correo electrónico de los asistentes a invitar |
| `sendUpdates` | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |
| `replaceExisting` | boolean | No | Si reemplazar los asistentes existentes o agregarlos \(por defecto es false\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `id` | string | ID del evento |
| `htmlLink` | string | Enlace del evento |
| `status` | string | Estado del evento |
| `summary` | string | Título del evento |
| `description` | string | Descripción del evento |
| `location` | string | Ubicación del evento |
| `start` | json | Inicio del evento |
| `end` | json | Fin del evento |
| `attendees` | json | Asistentes del evento |
| `creator` | json | Creador del evento |
| `organizer` | json | Organizador del evento |
