Skip to content

MCP server

Gmail MCP server

Google's own Gmail MCP server lets AI search and read threads, manage labels and create drafts. It has no send tool.

At a glance

Maintained by
Google (Google Workspace)
Tools exposed
10 listed below
Reviewed
September 24, 2026

Why it matters

What it does and why it matters

Email is still where most business requests arrive. Google now hosts a Gmail MCP server that lets an assistant search threads, read messages, list and create drafts and manage labels. It cannot send email, which is a sensible design: the assistant prepares, and a person sends.

That makes it a strong foundation for inbox triage: reading new messages, labeling them by topic and urgency, and drafting replies for review.

At review time, the server is part of Google's Workspace developer preview program, which requires membership. It signs in with your Google account and sees what your mailbox sees. For shared inboxes, we connect a dedicated account rather than a personal one.

Use cases

Best business use cases

Inbox triage

Label new messages by topic and urgency. See email triage.

Draft replies

Draft replies for a person to review and send.

Find past emails

Find what a customer said last month.

Thread summaries

Summarize long email threads.

Label clean-up

Apply consistent labels across old mail.

Tools

Available tools

Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.

Read and write: Read mail and write drafts and labels only; there is no send tool.

  • search_threads

    Find email threads that match a query.

  • get_thread

    Get a full conversation thread.

  • get_message

    Get a single message.

  • list_drafts

    List saved drafts.

  • create_draft

    Create a new draft email.

  • list_labels

    List all labels.

  • create_label

    Create a new label.

  • label_thread

    Add a label to a thread.

  • unlabel_thread

    Remove a label from a thread.

  • label_message

    Add a label to a message.

Workflows

Example workflows

Morning inbox triage

  1. 1

    The assistant searches unread mail.

  2. 2

    It labels each thread by topic and urgency.

  3. 3

    It drafts replies to routine questions.

  4. 4

    You review the drafts.

  5. 5

    You send the ones that are right.

Catch up on a customer

  1. 1

    Ask about a customer before a call.

  2. 2

    The assistant searches their threads.

  3. 3

    It summarizes recent requests and promises.

  4. 4

    It lists open questions.

  5. 5

    You go into the call prepared.

Prompts

Example prompts

  • “Label all unread emails from today by topic and mark urgent ones.”

  • “Summarize my last five threads with Harbor Group.”

  • “Draft a polite reply to this invoice question, but do not send it.”

Setup

Installation and configuration

Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.

Claude Code: terminal

claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 gmail https://gmailmcp.googleapis.com/mcp/v1
  • Hosted server: https://gmailmcp.googleapis.com/mcp/v1.
  • Needs: OAuth 2.0 with your own Google Cloud project and OAuth client; Developer Preview Program membership required..
  • Claude Desktop: Settings > Connectors > Add custom connector with URL https://gmailmcp.googleapis.com/mcp/v1 and your OAuth Client ID and Secret under Advanced settings.

Security

Security considerations

  • Approve outgoing messages

    Require a person to approve messages to customers until a workflow is proven.

  • Limit channels

    Give access only to the channels, mailboxes or numbers a task needs.

  • Untrusted messages

    Incoming messages can contain text meant to mislead an AI. Treat them as data.

  • Keep a log

    Keep a record of labels changed and drafts created.

Related servers

Servers that pair well with it

Google Drive

Google's own Drive MCP server lets AI search, read and create files in Google Drive, with your Google Workspace sign-in.

Google Calendar

Google's own Calendar MCP server lets AI list calendars and events, create, update and delete events, respond to invites and suggest times.

Slack

Slack's own hosted MCP server lets AI search messages, read channels and threads, look up people, draft or send messages and create canvases.

Keep exploring

FAQ

Questions people ask us

Have a question that is not here? Ask us directly.

Start a project

Want this connected to your own systems? We build AI workflows with MCP.

Send a short brief. We reply with questions, a suggested plan and an estimate you can compare with other offers.

Your privacy choices

We use necessary storage to run this site. With your permission we also use Google Analytics to see which pages help people, and load maps from Google. You can change this at any time. Read the cookie policy.