---
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`
