Gmail

Destination / action connector - Vendo creates Gmail drafts from approved AI workflows. The MCP Gmail tool creates drafts for review and does not send email directly.

Gmail is also available as a source for contact context.

What Vendo Creates

The Gmail destination surface is built for assistant email workflows, not bulk reverse ETL.

Output	Description
Email drafts	HTML Gmail drafts with recipients, subject, body, optional CC, and optional BCC
Labels	Drafts are labeled with `Vendo-Generated` by default, or with the labels configured on the Gmail app connection
Draft links	The tool returns a Gmail draft link so a user can review and send
Notifications	Vendo records a `gmail.draft_created` notification event after a draft is created

Send Safety

The MCP tool is intentionally draft-first.

Behavior	Status
Create draft	Supported
Return draft link	Supported
Apply labels	Supported
Send directly from MCP	Not supported
Configured auto-send	Safely downgraded to an inbox draft

This means generated email stays in Gmail for user review before it leaves the account.

OAuth Scopes

The Gmail write/draft permission can request:

Scope	Purpose
`https://www.googleapis.com/auth/gmail.compose`	Create Gmail drafts
`https://www.googleapis.com/auth/gmail.send`	Reserved for send-capable Gmail flows, though MCP draft creation does not call direct send
`https://www.googleapis.com/auth/gmail.labels`	Create or apply Gmail labels
`https://www.googleapis.com/auth/userinfo.email`	Identify the connected Google account email
`openid`	Google sign-in identity

The static Gmail fallback scope set may also include Gmail modify/settings, Google contacts, Google profile, and OpenID scopes. See Gmail source scopes for the full split.

Setup

Navigate to App Connections > Add App Connection
Select Gmail
Enable the Draft and send emails permission
Complete Google OAuth consent
Configure labels, send-as behavior, and signature behavior if needed
Use the AI assistant or MCP gmail_createDraft workflow to create a draft

Draft Inputs

The draft tool accepts these fields:

Field	Description
`to`	One or more recipient email addresses
`subject`	Email subject line
`body`	HTML email body
`cc`	Optional CC recipient list
`bcc`	Optional BCC recipient list

What Vendo Does Not Do

Data / action	Status
Bulk export events to Gmail	Not supported
Sync audiences to Gmail	Not supported
Send without user review from MCP	Not supported
Import Gmail contact tables	Use the Gmail source instead

Verify Setup

Run gmail_status from MCP or check the Gmail app connection
Create a test draft with gmail_createDraft
Open the returned Gmail draft link
Confirm the draft is labeled Vendo-Generated or with the configured label
Review and send from Gmail if the content is correct

Troubleshooting

Symptom	What to check
Draft creation says Gmail is not connected	Reconnect Gmail in App Connections
Draft lacks the expected label	Check the Gmail app connection label configuration
Auto-send did not happen	Expected for MCP; auto-send is downgraded to a draft for safety
Signature is missing	Check the Gmail signature mode: Gmail, custom, or none