> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendario

> Tu Google Calendar: una página por semana, tiempo libre y herramientas del agente que añaden o cambian eventos solo si dices que sí.

Calendario muestra tu Google Calendar en Archetype y deja que el agente lo lea. Viene activado por defecto. Aparece en la barra lateral como **Calendario**. Para activar y desactivar plugins, consulta [Plugins](https://docs.archetype.ing/es/extend/plugins.md).

## Conectarlo

Conecta Google Calendar en **Gestionar → Conexiones → Apps**. Calendario no guarda ninguna clave propia; llega a Google a través de esa conexión.

Con varias cuentas de Google conectadas, sus eventos se muestran juntos. Un evento nuevo va al calendario principal de la primera cuenta; un cambio, una eliminación o una respuesta va a la cuenta en la que está el evento.

## La página

La página muestra tu calendario principal personal, semana a semana.

* **Editar evento**: título, lugar, descripción, todo el día, fecha y horas. Los invitados y el calendario se quedan como están. Una hora nueva se confirma primero.
* **Repetir**: cada día, cada semana en los días elegidos, cada mes en su fecha o cada año, hasta un día o un número de veces. Los eventos que se repiten llevan la marca ↻. Al cambiar o eliminar uno, pregunta qué repeticiones: esta, todas, o esta y las siguientes.
* **Buscar un hueco**: tramos libres de al menos la duración que pides, de 09:00 a 18:00 entre semana, hasta 31 días por delante. Los eventos que rechazaste o marcaste como libres no cuentan como ocupados.
* **Otros calendarios**: unos interruptores muestran u ocultan tus otros calendarios en la página. Sus eventos son de solo lectura; todo cambio desde la página va al calendario principal.

Si el evento cambió en Google desde que lo abriste, el guardado se detiene y te pide que recargues primero.

## Qué puede hacer el agente

| Herramienta | Qué hace | Te pregunta |
| - | - | - |
| `calendar_events` | Lee eventos | No |
| `calendar_free_time` | Busca tiempo libre y, con `attendees`, también cuándo están ocupadas esas personas | No |
| `calendar_add_event` | Añade un evento e invita hasta a 50 personas | Cada vez |
| `calendar_update_event` | Cambia solo los campos que indica | Cada vez |
| `calendar_propose_event` | Deja una cita que encontró para que tú la añadas | No: decides tú en **Notificaciones** |

Añadir y cambiar te preguntan cada vez, incluso en `yolo`; si no hay nadie para responder, se rechazan. Consulta [Aprobaciones](https://docs.archetype.ing/es/use/approvals.md).

## Avisos y eventos

* Las **citas propuestas** esperan en **Notificaciones** con **Añadir** y **Descartar**. **Añadir** crea el evento.
* **`calendar.starting`**: se envía antes de que empiece un evento de tu propio calendario. No se avisa de los eventos de todo el día ni de los que rechazaste. Un [disparador](https://docs.archetype.ing/es/use/automations.md) puede activarse con él. Lleva el título, el inicio, los minutos que faltan, los asistentes, el lugar y el enlace de la reunión, nunca la descripción.

## Ajustes

En **Gestionar → Plugins → Calendario**:

| Ajuste | Por defecto | Qué hace |
| - | - | - |
| **Minutos antes de una reunión** | 10 | Cuánto antes de un evento se envía `calendar.starting` (de 1 a 120) |

## Perfil que ofrece

**Preparar reuniones** (solo lectura): antes de cada reunión, unas líneas sobre quién asiste, de qué hablaste con ellos la última vez (correo, mensajes, notas, grabaciones), qué hay pendiente entre tú y ellos y qué llevar o decidir. Se activa con `calendar.starting`. Crea uno en **Gestionar → Perfiles → Perfil nuevo**.

## Funciona con

La cronología de Personas, la pestaña Ahora del teléfono, el resumen del día y Grabaciones leen tus eventos a través de Calendario. Con Calendario desactivado (`"plugins": { "calendar": false }` en la [configuración](https://docs.archetype.ing/es/reference/config.md)), no hay página de Calendario, el agente no tiene herramientas de calendario y todo eso sigue sin tus eventos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.