gmail

name	gmail
description	Crear borradores de email en Gmail. Usa cuando el usuario diga "redactar email", "guardar borrador", "email borrador", "Gmail draft".
metadata	{"openclaw":{"emoji":"📧","requires":{"env":[]}}}

Gmail Skill

Rick puede crear y listar borradores de email en Gmail a través de las Worker tasks del Umbral Agent Stack.

Requisitos (al menos una vía de auth en el Worker)

El Worker resuelve credenciales en este orden (ver worker/tasks/gmail.py):

1. GOOGLE_GMAIL_TOKEN — OAuth2 Bearer (caduca en ~1 h).
2. GOOGLE_GMAIL_REFRESH_TOKEN + GOOGLE_GMAIL_CLIENT_ID + GOOGLE_GMAIL_CLIENT_SECRET — recomendado; el Worker renueva el access token (requiere google-auth).
3. GOOGLE_SERVICE_ACCOUNT_JSON — ruta al JSON de service account con scopes Gmail.

En el gateway, preferí las tools tipadas umbral_gmail_* del skill umbral-worker cuando ejecutes contra el Worker; este skill documenta payloads y comportamiento.

Documentación de obtención de tokens: docs/35-gmail-token-setup.md.

Tasks disponibles

1. Crear borrador

Task: gmail.create_draft

{
  "to": "[e-mail]",
  "subject": "Seguimiento reunión proyecto BIM",
  "body": "Estimado equipo,\n\nAdjunto los compromisos de la reunión...",
  "body_type": "plain",
  "cc": ["[e-mail]"],
  "reply_to": "[e-mail]"
}

Devuelve: {"ok": true, "draft_id": "...", "message_id": "..."}

Con HTML:

{
  "to": "[e-mail]",
  "subject": "Propuesta adjunta",
  "body": "<h1>Propuesta</h1><p>Detalle del proyecto...</p>",
  "body_type": "html"
}

2. Listar borradores

Task: gmail.list_drafts

{
  "max_results": 10,
  "q": "subject:seguimiento"
}

Devuelve: {"ok": true, "drafts": [{"id": "...", "message_id": "...", "snippet": "..."}, ...]}

Integración con Granola Pipeline

Cuando granola.create_followup se llama con followup_type: "email_draft" y los attendees incluyen direcciones de email, se crea automáticamente un borrador en Gmail además de registrarlo en Notion.

Notas

• El email se codifica en base64 formato RFC 2822.
• Soporta tanto OAuth Bearer como Service Account (con lazy import de google-auth).
• El parámetro q usa la misma sintaxis de búsqueda de Gmail.