Gmail MCP integration for AI agents.
A Gmail MCP integration for AI agents to find bounded threads, read messages, prepare drafts, send approved email, and manage labels through structured actions.
- ACTION CONTRACTS
- 46
- AUTHENTICATION
- OAuth 2.0
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the Gmail integration exposes
The Gmail Agent App supports a staged email workflow: search for a bounded set of threads, retrieve the message that matters, prepare a draft, and send only when the user has reviewed the recipients and content. This is safer than collapsing discovery and delivery into one opaque command.
Mailbox data is sensitive and is not automatically anonymized. Search terms should be specific, returned content should be minimized, and send permissions should be granted only when the workflow genuinely requires autonomous delivery.
VERIFIED ACTION SAMPLE
Real Gmail capabilities.
Showing 12 of 46 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
get_auto_forwardingREADGet the current Gmail auto-forwarding configuration.
INPUTS: userId
add_label_to_emailWRITEAdd and/or remove labels on a single Gmail message.
INPUTS: messageId / addLabelIds / removeLabelIds / userId
delete_draftHIGH IMPACTPermanently delete a Gmail draft by draft ID.
INPUTS: draftId / userId
batch_modify_messagesREVIEWAdd and/or remove labels on up to 1,000 Gmail messages.
INPUTS: messageIds / addLabelIds / removeLabelIds / userId
create_draftWRITECreate a Gmail draft with a simplified input and output shape.
INPUTS: to / subject / body / cc
create_email_draftWRITECreate a Gmail draft with recipients, subject, body, and optional threading.
INPUTS: recipientEmail / to / extraRecipients / cc / bcc
create_filterWRITECreate a Gmail filter with matching criteria and resulting actions.
INPUTS: criteria / action / userId
create_labelWRITECreate a new Gmail label and return its internal label ID.
INPUTS: name / labelListVisibility / messageListVisibility / color / userId
delete_filterHIGH IMPACTPermanently delete a Gmail filter by filter ID.
INPUTS: filterId / userId
delete_labelHIGH IMPACTPermanently delete a user-created Gmail label.
INPUTS: labelId / userId
fetch_emailsREVIEWList Gmail messages with optional query, label, and pagination filters. Use detail to choose IDs, summaries, or full messages.
INPUTS: query / labelIds / includeSpamTrash / detail / maxResults
fetch_message_by_message_idREVIEWFetch a Gmail message by message ID with a controllable response format.
INPUTS: messageId / format
INPUT CONTRACTS
Know what the action needs before it runs.
get_auto_forwarding
userIdOPTIONAL- Gmail user ID. Omit to use the connected mailbox.
add_label_to_email
messageIdREQUIRED- Gmail message ID.
addLabelIdsOPTIONAL- Gmail label IDs.
removeLabelIdsOPTIONAL- Gmail label IDs.
userIdOPTIONAL- Gmail user ID. Omit to use the connected mailbox.
delete_draft
draftIdREQUIRED- Gmail draft ID.
userIdOPTIONAL- Gmail user ID. Omit to use the connected mailbox.
batch_modify_messages
messageIdsREQUIRED- Message IDs to modify.
addLabelIdsOPTIONAL- Gmail label IDs.
removeLabelIdsOPTIONAL- Gmail label IDs.
userIdOPTIONAL- Gmail user ID. Omit to use the connected mailbox.
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Customer follow-up
Find the latest customer thread, combine it with CRM context, and create a draft for the account owner.
Support escalation
Retrieve the affected conversation, draft an acknowledgement, and attach the verified ticket reference.
Inbox triage
Classify a limited query result and suggest labels or drafts without deleting or sending messages.
SAFETY BOUNDARY
Operate Gmail with explicit limits
- Prefer draft creation to autonomous sending.
- Confirm To, Cc, Bcc, subject, attachments, and final body.
- Avoid broad mailbox extraction when a Gmail query can narrow the task.
- Verify the returned message or draft identifier.
CONNECTION MODEL
OAuth 2.0
Gmail uses OAuth 2.0. Connection requirements and availability are determined by the provider and the Working Machines deployment.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 17
- WRITE SIGNALS
- 17
- HIGH IMPACT
- 3
- REVIEW SIGNALS
- 9
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by Gmail.