google-calendar

name	google-calendar
description	Crear y listar eventos en Google Calendar. Usa cuando el usuario diga "agendar reunion", "crear evento", "recordatorio en calendario", "ver mis eventos", "Google Calendar".
metadata	{"openclaw":{"emoji":"📅","requires":{"env":[]}}}

Google Calendar Skill

Rick puede crear y listar eventos en Google Calendar a traves de las Worker tasks del Umbral Agent Stack.

Documentación de credenciales y verificación: docs/35-google-calendar-token-setup.md.

Requisitos

• GOOGLE_CALENDAR_REFRESH_TOKEN + GOOGLE_CALENDAR_CLIENT_ID + GOOGLE_CALENDAR_CLIENT_SECRET: opcion persistente recomendada; el Worker renueva el access token solo.
• GOOGLE_CALENDAR_TOKEN: OAuth2 Bearer token con scope calendar (temporal, caduca en ~1 h).
• Alternativa: GOOGLE_SERVICE_ACCOUNT_JSON (ruta al archivo JSON de service account con scope calendar).

Tasks disponibles

1. Crear evento

Task: google.calendar.create_event

{
  "title": "Reunion de seguimiento con Cliente X",
  "description": "Revisar avance del proyecto BIM",
  "start": "2026-03-10T10:00:00",
  "end": "2026-03-10T11:00:00",
  "timezone": "America/Santiago",
  "attendees": ["[e-mail]", "[e-mail]"],
  "calendar_id": "primary"
}

Devuelve: {"ok": true, "event_id": "...", "html_link": "..."}

Evento de dia completo (sin hora de fin):

{
  "title": "Deadline propuesta",
  "start": "2026-03-15T00:00:00"
}

2. Listar eventos

Task: google.calendar.list_events

{
  "calendar_id": "primary",
  "time_min": "2026-03-01T00:00:00Z",
  "max_results": 10
}

Devuelve: {"ok": true, "events": [{"id", "summary", "start", "end", "html_link"}, ...]}

Notas

• Todas las tasks se encolan via el Dispatcher a Redis y las ejecuta el Worker.
• El timezone por defecto es America/Santiago.
• El calendar_id por defecto es primary.
• Para calendarios compartidos, no usar primary: pasa el calendar_id explicito del calendario compartido.
• Soporta refresh token OAuth, OAuth Bearer temporal y Service Account (con lazy import de google-auth).