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
`gmail_messages_list`	Search or list messages
`gmail_message_get`	Get a single message
`gmail_message_send`	Send an email
`gmail_threads_list`	Search or list threads
`gmail_labels_list`	List all labels
`gmail_message_archive`	Archive a message (remove from inbox)

Detailed Usage

gmail_messages_list▶

Search or list Gmail messages.

gmail_message_send▶

Send an email.

gmail_thread_get▶

Get all messages in a thread.

gmail_message_archive▶

Archive a message (remove it from the inbox).

Installation

Run from a local checkout of domdomegg/gmail-mcp after installing its dependencies:

GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

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