Version2.0.0
Categorygoogle
AuthOAuth 2
Tools19
Transportstdio
LicenceMIT
01
What it does
The app, in its own words.
Gmail email management — send, read, search, label, and filter emails via Google Gmail API.
02
Tools
19 tools the agent can call.
Every one is declared with typed parameters and returns structured results, so the host can render them instead of narrating them.
- create-draftCreate a draft email message.
- create-filterCreate a new Gmail filter to automatically organize emails.
- create-labelCreate a new Gmail label.
- delete-draftDelete a draft email by its draft ID.
- delete-filterDelete a Gmail filter by its ID.
- delete-labelDelete a Gmail label. This does NOT delete the emails with this label.
- get-attachmentGet the content of an email attachment by its attachment ID.
- get-messageGet full details of a specific email message by ID.
- list-draftsList all draft emails in the account.
- list-filtersList all Gmail filters for the account.
- list-labelsList all Gmail labels (both system and custom labels) for the account.
- list-messagesList email messages from inbox or specific labels. Supports filtering by unread, starred, etc.
- modify-labelsAdd or remove labels from a message (e.g., mark as read/unread, archive, star).
- reply-messageReply to an existing email message.
- search-messagesSearch for email messages using Gmail's search syntax.
- send-messageSend an email message from the specified account.
- store-attachmentDownload and store an email attachment to the local filesystem.
- update-draftUpdate an existing draft email by replacing its content.
- update-labelUpdate an existing Gmail label (name, colors, visibility).
03
Auth and permissions
What it asks for.
Declared in the manifest, in advance. The app cannot reach anything it did not ask for here.
Scopes
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/gmail.sendhttps://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/userinfo.email
System secrets
CLIENT_IDCLIENT_SECRETREDIRECT_URI
User secrets
ACCESS_TOKENREFRESH_TOKENEMAILEXPIRY_DATE
Reading further
The manifest and the source for Gmail live in the monorepo, alongside the other apps.