gmail-dispatcher

A private, single-user mail automation running on the owner's own machine.

gmail-dispatcher watches one Gmail mailbox belonging to its operator. When a message arrives that is addressed to a specific whitelisted recipient address, the tool passes that message on to the operator's own assistant, which summarises it for them.

It is not a product and has no users other than its author. There is no sign-up, no hosted service and no third party involved. The source is a private repository; this page exists because Google requires an application using the Gmail API to publish a home page and a privacy policy.

How it works

1. Gmail notifies a Google Cloud Pub/Sub topic that the mailbox changed.
2. The tool, running on the operator's own machine, pulls that notification. It is not a public web service and accepts no inbound connections.
3. It asks the Gmail API which messages are new, and reads only their headers — sender, recipients, subject, date.
4. If a message is addressed to the whitelisted address, its Gmail message id is handed to the operator's assistant. Everything else is ignored.