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.

From the repo · “Gmail Processor is a Google Apps Script library that automates the processing of Gmail messages and attachments and execute actions (e.g. store attachments in a GDrive folder, log information in a spreadsheet) depending on matching criteria.”

585 stars143 forksTypeScriptGuide quality 8/10 · reviewed Jul 9Updated 10/20/2026100% free · open source

What it does

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

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

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

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

✅ Light setup

Installs with a command or two; your AI agent can do it for you.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/gmail-processor && curl -fsSL https://workflowstacks.com/api/skills/gmail-processor/claude-skill -o ~/.claude/skills/gmail-processor/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How Gmail Processor: Automate Email Tasks works

Codeflow

Free to inspect

Gmail Processor: Automate Email Tasks is a large TypeScript project (~24k lines across 206 code files, plus 17 test files). Setup is light: installs like a normal app. Reading the code is optional. Last commit this month, Apache-2.0 license, has a test suite.

Size

Large codebase

~24k lines · 206 code files · ~3 h to skim

Setup

One-command install

Installs like a normal app. Reading the code is optional.

Runs on

Node.js

No API keys detected

TypeScript 89%JavaScript 6%Shell 3%jq 1%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
package.json
Dependencies and the commands it exposes
4
src/examples/index.ts
Inside src/ — the main logic begins here

What's in each folder

src/Core code — the actual logic241 files

skills/Prompts, skills & agent definitions1 files

docs/Documentation71 files

openspec/Folder42 files

scripts/Helper scripts32 files

git-hooks/Folder3 files

.github/CI / automation (GitHub Actions)10 files

READMEHas testsDocumentedCI checksApache-2.0 licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

✅ Light setup

Installs with a command or two; your AI agent can do it for you.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/gmail-processor && curl -fsSL https://workflowstacks.com/api/skills/gmail-processor/claude-skill -o ~/.claude/skills/gmail-processor/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

ahochsteger

Language

TypeScript