Gmail

Read, search, draft, and send Gmail messages.

Works with: Claude DesktopCursor
Quick install
npx -y gmail-mcp-server

How to install the Gmail MCP server

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp-server"
      ]
    }
  }
}

Add this to your Cursor MCP configuration:

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp-server"
      ]
    }
  }
}

The Gmail MCP server gives Claude scoped access to your Gmail account. Read messages, search across history, draft replies, send emails, manage labels. For solo workers handling their own inbox, it collapses inbox triage into single prompts.

Why use it

Most inbox triage is repetitive: scan unread, archive what’s done, surface what needs attention, draft replies for the rest. Claude with the Gmail MCP can do all four with one prompt.

For job seekers, sales, or anyone running outbound, the server pairs with HubSpot or Apollo.io for “follow up on this sequence” workflows.

What it actually does

Read messages by query (from, subject, label, date), get full message contents, list labels, draft messages, send messages, apply labels, archive, mark read/unread.

Practical patterns:

  • “Summarize my unread emails from the last 24 hours and tell me what needs a reply.”
  • “Draft a polite decline to the meeting request from [email protected].”
  • “Find every email from my accountant in the last quarter and pull the receipts as attachments.”

Gotchas

Send scope is high-risk. Default to draft + manual review. Only enable send scope for explicit automation workflows where you trust Claude to compose correctly.

Search syntax is Gmail’s. Operators like from:, subject:, label: all work. Help Claude by including them in prompts when you know the right query.

For respondent management and outbound, pair Gmail with Brevo or HubSpot. Gmail handles the personal inbox; the dedicated tools handle scaled outbound.

Gmail MCP server: FAQs

Is there an official Gmail MCP server?

Google has not shipped an official Gmail MCP as of early 2026. The most popular community server is GongRzhe/Gmail-MCP-Server. It's well-maintained and widely used.

How is auth handled?

OAuth via Google. The server requests gmail.readonly or gmail.modify scopes. Choose narrow scopes for safety.

Can it actually send emails?

Yes, with gmail.send scope. Treat this scope with care. A misinterpreted prompt can send unintended email.

Does it support labels and folders?

Yes. List labels, filter by label, apply or remove labels. Useful for triage workflows.

Can it read attachments?

Yes for text, images and PDFs are returned as base64. For deep document parsing, pair with the [Filesystem](/tools/mcp-server-directory/filesystem/) and PDF handlers.