GWS for Dummies

GMAIL · TASKS · CALENDAR

Turn a crowded inbox into a system you can understand.

GWS for Dummies lets you tell an AI coding agent what you want in plain English. It uses the Google Workspace CLI to label mail, create Tasks and Calendar events, and prepare useful recaps without sending, trashing, or deleting anything.

Read the docs ↓

Set up with your coding agent

Open any supported agent and paste the instruction below. It will read the setup guide and walk you through installing the CLI, connecting your Google account, and running your first inbox triage.

Works with
  • Codex
  • Claude Code
  • Cursor
  • OpenCode
  • Pi
  • Gemini CLI
set up gws for dummies — https://gws-for-dummies.vercel.app/llms.txt

Prefer the terminal? Run the setup script yourself. On Windows, use Git Bash or WSL.

git clone https://github.com/Mulla759/GWSforDummies.git && cd GWSforDummies && ./setup.sh
Illustrative output — the setup command and a sample triage run.

What it does

01 / TRIAGE PREDICTABLE

Triage mail into clean labels

Understands sender and intent, then applies a predictable label taxonomy.

See the label rules ↗
02 / ACT UNDOABLE

Turn action mail into Tasks and events

Creates traceable Tasks and Calendar events with source links and undo notes.

See what gets created ↗
Illustrative flow — messages are classified, routed to specialist agents, and checked before changes are made.
03 / RECAP READ-ONLY

Review the week without reopening every thread

Produces a read-only summary of meetings, unread mail, and triage activity.

Preview a recap ↗
04 / AUTOPILOT IDEMPOTENT

Keep the inbox organized overnight

Runs deterministic, idempotent sender-to-label rules locally or in GitHub Actions.

See the nightly workflow ↗

Docs

Set up in three steps.

01  Install

Install the Google Workspace CLI and clone the project.

npm install -g @googleworkspace/cli
git clone https://github.com/Mulla759/GWSforDummies.git && cd GWSforDummies

02  Authenticate

Sign in to your own Google account. The runbook covers creating the OAuth client first.

gws auth login -s "gmail,tasks,calendar"
Need the OAuth client step?

The agent runbook walks through creating a free Google Cloud project, enabling the Gmail, Calendar, and Tasks APIs, and placing client_secret.json. Open the full runbook

03  Ask your agent

Describe what you want in plain English.

gws-do "triage my inbox"

Safety model

Reads and labels. Never sends, trashes, or deletes.

Portrait of Abdullahi Abdi

Built by Abdullahi Abdi

Student · Computer scientist

Have a setup issue, an improvement, or a workflow worth adding? I’d like to hear about it.