Overview

The Gmail MCP Server brings Google's email platform to AI assistants via the Model Context Protocol. Built on the Gmail API, this server enables AI models to read, compose, send, and organize emails — managing threads, labels, and attachments. With over 1.8 billion active users, Gmail is the world's most popular email service.

Community MCP Server:

Integrates with the official Gmail API using OAuth 2.0 authentication

Key Features

📥

Read & Search Emails

Search your inbox with Gmail's powerful query syntax, read message content, and view attachments

✏️

Compose & Send

Draft and send emails with support for recipients, CC, BCC, subject lines, and body content

🧵

Thread Management

Follow email threads, reply to conversations, and track message history

🏷️

Labels & Organization

Apply labels, manage categories, archive, star, and organize your inbox automatically

📎

Attachment Handling

Send and receive file attachments, extract content from attachments for processing

📋

Inbox Triage

Identify urgent messages, summarize unread emails, and prioritize your inbox

Available Tools

Quick Reference

Tool	Purpose
`search_emails`	Search emails using Gmail's query syntax
`read_email`	Read the content of a specific email
`send_email`	Compose and send a new email
`reply_to_thread`	Reply to an existing email thread
`list_labels`	List all Gmail labels and categories
`modify_message`	Apply label, archive, trash, or star an email

Detailed Usage

search_emails▶

Search emails using Gmail's advanced search operators.

{
  "query": "from:[email protected] is:unread",
  "max_results": 10
}

send_email▶

Compose and send a new email with optional CC, BCC, and attachments.

{
  "to": ["[email protected]"],
  "subject": "Meeting Follow-up",
  "body": "Thanks for the productive meeting. Here are the action items..."
}

reply_to_thread▶

Reply to an existing email thread, preserving conversation history.

{
  "thread_id": "189abcd1234",
  "body": "I'll have the report ready by Friday."
}

modify_message▶

Modify message labels or move to archive/trash.

{
  "message_id": "189abcd1234",
  "action": "archive"
}

Installation

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "gmail-mcp"],
      "env": {
        "GMAIL_OAUTH_PATH": "/path/to/credentials.json"
      }
    }
  }
}

OAuth 2.0 Required:

You'll need a Google Cloud Project with the Gmail API enabled and OAuth 2.0 credentials. Follow the Gmail API quickstart to set up.

Use Cases

Inbox Management

Have AI summarize your unread emails, flag urgent messages, and organize your inbox.

Email Drafting

Ask AI to draft professional email responses based on context from previous messages.

Information Retrieval

Search for specific information buried in your email history — receipts, confirmations, attachments.

Email Automation

Automate routine email tasks like sorting, labeling, archiving, and templated responses.

Gmail MCP Server