listener-creator

Email listeners automate inbox management by monitoring events like email_received or email_archived and triggering actions such as notifications, labeling, or archiving. Define event types, set filter conditions, and provide a handler function that uses ListenerContext methods to perform actions when events occur.

Yes. Listeners support AI-assisted decision-making through context.callAgent, enabling intelligent email classification and routing. Your handler can invoke the agent to analyze email content and determine whether to notify, archive, label, or perform other actions based on urgency or custom criteria.

Create a TypeScript file under agent/custom_scripts/listeners that exports a config object defining the event type and filter conditions, plus a handler function. The handler receives ListenerContext and uses methods like notify, archiveEmail, starEmail, and addLabel to respond to events like email_received, email_sent, or scheduled_time.

Supported events include email_received, email_sent, email_starred, email_archived, email_labeled, and scheduled_time. Each event triggers your handler, allowing you to monitor incoming and outgoing emails or execute scheduled actions across your Gmail account.

Use scheduled_time events for daily summaries or email_received with AI classification for urgent alerts. Configure your listener to query recent emails, apply AI analysis via context.callAgent to determine priority, then notify or aggregate results using ListenerContext methods.

No. Listeners abstract event-driven complexity into a simple config-and-handler pattern. If you're familiar with TypeScript functions and email workflows, you can define conditions and write handlers; AI-assisted classification and ListenerContext methods handle the technical details.