automation

Gmail Processor: Automate Email Tasks

Name: Gmail Processor: Automate Email Tasks
Author: ahochsteger

Founders automate Gmail tasks with Gmail Processor, a script library for processing messages and attachments.

583 stars142 forksTypeScriptQuality 8/10Updated 7/7/2026100% free · open source

What it does

Gmail Processor automates Gmail tasks by processing messages and attachments using a TypeScript script library.

Install / run

npm install gmail-processor

When to use it

•Receiving daily reports via Gmail and need to extract data automatically
•Sending automated responses to common customer inquiries
•Managing a high-volume inbox and need to filter, label, or forward emails based on specific criteria

Quick start

1Create a new TypeScript file, e.g., `gmail-processor.ts`, and import the GmailProcessor class
2Set up a Gmail API project and enable the Gmail API, then create credentials for your project (OAuth client ID)
3Install the required dependencies, including `@google-auth-library` and `@google/apis`
4Configure your Gmail API credentials in the `gmail-processor.ts` file using the `GmailProcessor.setCredentials()` method
5Use the `GmailProcessor.processMessages()` method to start processing incoming Gmail messages

Ready-to-paste prompt

const processor = new GmailProcessor(); processor.processMessages('label:unread', (message) => console.log(message.subject));

Heads up: To use Gmail Processor, you need to have a Gmail API project set up and enable the Gmail API, which requires a Google Cloud account and may incur costs depending on usage

Saves to your device