Skip to main content
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
  • Organize your inbox by starring, archiving, or labeling
  • 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 toolsConnect 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
Send EmailSend new emails or replies
Update EmailUpdate labels (read/unread, folders)
Create DraftPrepare emails without sending
Forward EmailForward to other recipients
Create LabelCreate new Gmail labels
Archive EmailMove emails out of inbox
Trash EmailMove emails to trash
Star/Unstar EmailManage starred emails
Get Attachment DetailsList attachment metadata
Download AttachmentGet download URLs for 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 [email protected] 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
Create a draft:
Create a draft reply to the latest email from my manager

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.