Summary
Gmail search syntax, available to an agent that can then act on what it finds.
The useful part is that search-emails takes real Gmail queries rather than a reduced filter set, so anything you already know how to find in the web client is findable here — and get-email pulls the whole message once the search narrows it down.
What it is
A Gmail server over the Gmail API: list what is in the inbox, search it, open a single message, and read the label set.
What you get
- Recent inbox mail, filtered by sender or by label, with a result cap you set
- Search using Gmail's own syntax — from:, has:attachment and the rest work unchanged
- One message pulled in full by its ID
- The account's labels, so a filter can name the right one
Requirements
Your own Google Cloud project with the Gmail API enabled and OAuth desktop credentials saved to disk, then one browser sign-in that writes the credentials file. Bun is used to install and build.
