Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

Gmail is Google’s email service used by billions worldwide. The Gmail MCP server lets you search, read, send, and organize emails using natural language.

​
What Can It Do?

  • Search and read emails with any filter, label, or timeframe
  • Send emails and replies from within workflows
  • Manage drafts — list, create, update, send, or delete drafts
  • Work with threads — retrieve full email conversations
  • Organize your inbox by starring, archiving, labeling, or batch-updating
  • Manage labels — create, update, and delete custom labels
  • Send emails with file attachments from Gumloop storage
  • Download attachments for automated processing

​
Where to Use It

Add Gmail as a tool to any agent. The agent can then interact with your inbox conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Gmail tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Find emails from Stripe about invoices”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
Read EmailsSearch and read emails (supports body_format: text, html, or raw)
Send EmailSend new emails or replies (supports optional sender for Send As aliases and file attachments from Gumloop storage)
Update EmailUpdate labels (read/unread, folders)
Create DraftPrepare emails without sending (supports optional sender for Send As aliases and file attachments from Gumloop storage)
List DraftsList email drafts in the mailbox with optional search query
Update DraftUpdate an existing email draft with new content (supports file attachments from Gumloop storage)
Delete DraftPermanently delete an email draft
Send DraftSend an existing email draft
Forward EmailForward to other recipients (supports optional sender for Send As aliases)
Get ThreadGet a full email thread with all messages
Create LabelCreate new Gmail labels
Update LabelUpdate a label’s name, colors, or visibility settings
Delete LabelDelete a custom Gmail label (system labels cannot be deleted)
List LabelsList all Gmail labels with their IDs
Archive EmailMove emails out of inbox
Trash EmailMove emails to trash
Star/Unstar EmailManage starred emails
Batch Update EmailsModify labels on multiple emails at once
Get AttachmentDownload and access email attachments

​
Example Prompts

Use these with your agent or in the Agent Node: Search emails: 
Find emails from Stripe with "invoice" in the subject from this month
Send an email: 
Send an email to sarah@company.com about the project kickoff
Organize inbox: 
Archive all newsletters older than 30 days
Download attachments: 
Download the PDF attachments from the latest expense report email
Send with attachments: 
Send an email to john@company.com with the file "report.pdf" from my storage attached
Create a draft: 
Create a draft reply to the latest email from my manager
Manage drafts: 
List my recent drafts and send the one about the project proposal
View a thread: 
Show me the full conversation thread for the latest email from Sarah
Batch update: 
Add the "Reviewed" label to all emails from the hiring team this week

​
Troubleshooting

IssueSolution
Agent not finding the right dataUse specific sender addresses or date ranges
Action not completingCheck that you’ve authenticated with Gmail
Unexpected resultsThe agent may chain multiple tools (e.g., searching first, then downloading). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Forward the invoice from Stripe to accounting” will find the email first, then forward it. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Gmail MCP server using your Gumloop credentials.