Gmail
Search, batch-process Gmail messages and export thread data to Sheets from your agent during build and support automation.
Overview
Gmail (io.github.mcp-z/mcp-gmail) is an MCP server for the Build phase that lets agents authenticate to Gmail, search messages, run batch mail operations, and export results toward Sheets.
What is this MCP server?
- OAuth loopback or service-account authentication for Gmail API access
- Message search and batch operations across labels and queries
- Export paths toward Google Sheets for tabular mail-derived data
- Headless OAuth and configurable redirect URI for remote agents
- stdio MCP via npx @mcp-z/mcp-gmail (v1.0.10)
- Server version 1.0.10
- 2 auth choices: loopback-oauth and service-account
- Package identifier @mcp-z/mcp-gmail with stdio transport
What problem does it solve?
Debugging or automating inbox workflows forces context switches to the Gmail UI and brittle one-off API scripts.
Who is it for?
Builders connecting agents to real Gmail for support triage, audit trails, or Sheets-backed mail analytics.
Skip if: High-volume transactional sending platforms or teams that cannot use Google OAuth or Workspace API quotas.
What do I get? / Deliverables
With MCP registered and Google auth complete, the agent can query and batch Gmail and produce exportable datasets from mail.
- Authenticated Gmail search and batch tool surface
- Export-friendly mail datasets via configured resource store
- Repeatable agent workflows over production or staging inboxes
Recommended MCP Servers
Journey fit
Gmail MCP is most often wired while building email-backed features, onboarding flows, or internal ops bots that must read real inboxes. It connects to an external messaging API rather than implementing send logic in your app codebase alone.
How it compares
Gmail API MCP adapter, not a marketing ESP integration or a local mail client skill.
Common Questions / FAQ
Who is Gmail MCP for?
Solo builders and tiny teams who use Claude Code or Cursor and need programmatic Gmail read and batch workflows.
When should I use Gmail MCP?
Use it when an agent must search threads, batch-label or process messages, or export mail data while building or operating a product.
How do I add Gmail MCP to my agent?
Configure npx @mcp-z/mcp-gmail in MCP settings, set --auth to loopback-oauth or service-account, grant Gmail API scopes, then reload the client.