Full Gmail access via the Google API. Read your inbox, send emails, search by query, manage labels, and archive messages. Uses OAuth 2.0 — your credentials never leave your machine.
Credentials
| Name | Label | Required |
|---|---|---|
GOOGLE_CLIENT_ID | Google OAuth Client ID | required |
GOOGLE_CLIENT_SECRET | Google OAuth Client Secret | required |
Setup
terminal
# 1. Enable Gmail API at console.cloud.google.com
# 2. Create OAuth 2.0 credentials (Desktop app type)
# 3. Run setup — it will open a browser for OAuth consent:
conductor plugins setup gmailInstall
Built-in — enable with conductor plugins enable gmail
Tools
| Tool | Description | Inputs | Approval |
|---|---|---|---|
gmail_list | List messages in inbox or by query | query?, maxResults? | — |
gmail_read | Read a message by ID | id | — |
gmail_send | Send an email | to, subject, body, cc? | required |
gmail_reply | Reply to a thread | threadId, body | required |
gmail_archive | Archive a message | id | required |
gmail_label | Apply or remove a label | id, label, action | required |
gmail_search | Search messages with Gmail query syntax | query, maxResults? | — |
Tools marked required will prompt the user for approval before execution. These are typically write, delete, or send operations.
Example Prompts
“Show my unread emails from today”
gmail_list“Send an email to john@example.com about the meeting”
gmail_send“Find emails from my bank in the last 30 days”
gmail_search