Summary
Mail search for an agent, with nothing granted that could send or delete.
It asks Google for read access and nothing else, which makes it the version of Gmail access you can hand to an assistant without thinking hard about it — and the search takes real Gmail queries, so narrowing is as precise as it is in the web client.
What it is
A read-only Gmail server: one search tool over Gmail's own query syntax, plus a resource that returns your ten most recent inbox messages.
What you get
- A search over your mail using Gmail's standard query syntax
- A result cap you set per search, defaulting to ten
- Your ten most recent inbox messages, available as a resource without a search
- Read access only — the OAuth scope requested carries no write permission
Requirements
A Google Cloud project with the Gmail API enabled and OAuth desktop credentials downloaded, then two paths in the environment: one pointing at those credentials, and one where the token is written after you authorize in the browser. Python, installed into its own environment.