Read and manage Gmail across all connected Google accounts — search, send, reply, draft, archive, and label emails.
This skill guides you in using the google_gmail MCP tool to manage email across all connected Google accounts.
| Subcommand | Description |
|---|---|
list | List recent emails (defaults to INBOX). Use --query for Gmail search. |
read <messageId> | Read a full email thread by message ID. |
send | Compose and send a new email. |
reply <messageId> | Reply to a specific message. |
draft | Save a draft without sending. |
archive <messageId> | Archive a message (remove from INBOX). |
mark-read <messageId> |
| Mark a message as read. |
mark-unread <messageId> | Mark a message as unread. |
label <messageId> | Apply or remove Gmail labels. |
account to query all accounts simultaneously.account. If the user hasn't said which account, ask them first.google_gmail(command: "list --query 'is:unread'") // all accounts
google_gmail(command: "send --to '[email protected]' --subject 'Hi'", account: "Work")
| Flag | Description |
|---|---|
--query <q> | Gmail search query (list only) |
--max <n> | Max results to return (default: 20) |
--to <addr> | Recipient email address |
--cc <addr> | CC recipient |
--subject <text> | Email subject |
--body <text> | Email body (plain text) |
--label-ids <ids> | Comma-separated label IDs to add/remove |
google_gmail(command: "list --query 'is:unread'")google_gmail(command: "read <messageId>")google_gmail(command: "reply <messageId> --body 'Thanks!'", account: "Work")account is required but not specified, ask the user which account to use before proceeding.