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
  • 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

​
Example Prompts

Use these with your agent or in the Agent Node: Search emails:
Send an email:
Organize inbox:
Download attachments:
Send with attachments:
Create a draft:
Manage drafts:
View a thread:
Batch update:

​
Troubleshooting

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 credentials from your Connectors page.