Gmail servers usually lose people at the Google Cloud step; here the installer takes over once the credentials file is in Downloads and handles naming, placement and client config itself. What you get on the other side is a broad surface — attachments, threads, and label management down to colour and visibility — so an assistant can file mail, not just read it.
A Gmail server for Claude Desktop that covers sending, reading, searching and labelling. Its distinguishing feature is the setup script: you download the OAuth client secret from Google Cloud, leave it in Downloads, and the installer detects it, renames it and writes the client config.
- Send mail with attachments, CC, BCC, or as a reply into an existing thread
- Create drafts, including drafts with attachments
- Read a message by ID in text and HTML, chunked when the message is large
- Search with query, labels, sender, has-attachment and pagination
- Pull a whole conversation thread, and download attachments from a message
- Mark messages read, unread, important or not important
- Label management: create, list, rename, recolour, change visibility, search by name, delete by name, add to or remove from a message
Claude Desktop, Python 3.11 or higher, git and a Gmail account. In Google Cloud you create a project, enable the Gmail API and add `http://localhost:8080/` as an authorised redirect URI — miss that one line and the OAuth round trip fails. Then run `python setup.py` on Windows or `python3 setupUnix.py` on macOS and Linux. Configuring by hand, the credentials file goes to `credentials/client_secret_gmail_oauth.json`. MIT licensed. The README is in Spanish.
