Documentación

Recetas

Receta · Agente que responde Gmail

OAuth a Gmail → tool use → LangGraph que lee y contesta correos.

OpenAILangGraphMCPAuth

Necesitas antes:

  • Haber llegado a las Semanas 4–5 del curso (tool use + agentes).
  • Credenciales OAuth de Google Cloud en web/.env.local: GOOGLE_OAUTH_CLIENT_ID y GOOGLE_OAUTH_CLIENT_SECRET (ver Variables de entorno).

OAuth es la forma estándar de darle a una app permiso para usar tu cuenta de otro servicio (aquí: que tu agente pueda leer y mandar correos de tu Gmail) sin entregarle tu contraseña.

Estas credenciales son distintas de las del login con Google de tu app. Las del login van en el dashboard de Supabase (ver Login con Google); estas van en web/.env.local y le dan a tu agente acceso a Gmail.

Receta en construcción — se completará junto con la feature de agentes del boilerplate. Inspirada en el post de Auth0 sobre agentes seguros con Gmail.

Qué construyes

Un agente que:

  1. Recibe un objetivo en lenguaje natural ("revisa mis correos no leídos y contesta los que sean preguntas simples").
  2. Autentica con Gmail vía OAuth.
  3. Lee los correos no leídos.
  4. Decide cuáles son simples y cuáles requieren tu atención.
  5. Redacta y envía respuestas a los simples.
  6. Te resume al final qué hizo.

Por qué importa

Es el patrón completo tool use + agente + OAuth externo. Lo que aprendas aquí se aplica a Slack, Notion, Linear, cualquier API con OAuth.

Pasos (preview)

  1. Configurar OAuth Gmail en Google Cloud Console.
  2. Guardar tokens en profiles (encriptados). La columna para guardarlos aún no existe en la tabla — llegará con esta receta.
  3. Registrar tools: listUnreadEmails, readEmail, sendReply.
  4. Armar grafo LangGraph: fetch → classify → respond → report.
  5. Exponer la tarea como MCP server o como página.

Entregable

Un agente que demuestras en Demo Day procesando tu propio inbox.