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
- Download attachments for automated processing
Where to Use It
In Agents (Recommended)
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:- Open your agent’s configuration
- Click Add tools → Connect an app with MCP
- Search for the integration and select it
- Authenticate with your account
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.- Go to your node library and search for the integration
- Click Create a node with AI
- Describe the specific action you want (e.g., “Find emails from Stripe about invoices”)
- 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
| Tool | Description |
|---|---|
| Read Emails | Search and read emails (supports body_format: text, html, or raw) |
| Send Email | Send new emails or replies (supports optional sender for Send As aliases) |
| Update Email | Update labels (read/unread, folders) |
| Create Draft | Prepare emails without sending (supports optional sender for Send As aliases) |
| List Drafts | List email drafts in the mailbox with optional search query |
| Update Draft | Update an existing email draft with new content |
| Delete Draft | Permanently delete an email draft |
| Send Draft | Send an existing email draft |
| Forward Email | Forward to other recipients (supports optional sender for Send As aliases) |
| Get Thread | Get a full email thread with all messages |
| Create Label | Create new Gmail labels |
| Update Label | Update a label’s name, colors, or visibility settings |
| Delete Label | Delete a custom Gmail label (system labels cannot be deleted) |
| List Labels | List all Gmail labels with their IDs |
| Archive Email | Move emails out of inbox |
| Trash Email | Move emails to trash |
| Star/Unstar Email | Manage starred emails |
| Batch Update Emails | Modify labels on multiple emails at once |
| Get Attachment | Download and access email attachments |
Example Prompts
Use these with your agent or in the Agent Node: Search emails:Troubleshooting
| Issue | Solution |
|---|---|
| Agent not finding the right data | Use specific sender addresses or date ranges |
| Action not completing | Check that you’ve authenticated with Gmail |
| Unexpected results | The agent may chain multiple tools (e.g., searching first, then downloading). Review the agent’s reasoning to understand its approach. |
| Tool not available | Verify the tool is enabled in your agent’s MCP configuration |
Need Help?
- Agents documentation for setup and best practices
- Agent Node guide for workflow integration
- Gumloop Community for questions and examples
- Contact support@gumloop.com for assistance
Use this integration directly in Claude or Cursor. Connect remotely via the Gmail MCP server using your Gumloop credentials.