Gmail MCP Server

@MCP-Mirror

About Gmail MCP Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ajbr0wn_gmail-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "gmail_mcp_server.server"
      ]
    }
  }
}

Tools

Search Gmail emails with a query

Overview

What is Gmail MCP Server?

Gmail MCP Server is an MCP (Model Context Protocol) server that provides Gmail integration capabilities to MCP clients like Claude Desktop. It uses secure OAuth2 authentication to read emails from your Gmail account.

How to use Gmail MCP Server?

Set up a Google Cloud Project, enable the Gmail API, and create OAuth 2.0 credentials. Install the server in a conda environment with Python 3.12, then configure it in your Claude Desktop config file by providing paths to the credentials and token files. On first run, you authorize the application in your browser.

Key features of Gmail MCP Server

View the 10 most recent emails from your inbox
Search emails using standard Gmail search syntax
Secure OAuth2 authentication (read‑only access)
Automatic token refresh

Use cases of Gmail MCP Server

Ask a coding assistant to check recent emails
Search for specific messages by sender, date, or subject
Retrieve recent messages without leaving your workflow

FAQ from Gmail MCP Server

What resources and tools does the server provide?

It provides a resource gmail://inbox/recent that returns your 10 most recent emails, and a tool search_emails that accepts a Gmail search query and optional max_results parameter (default 10).

How do I authenticate with Gmail?

You must create OAuth 2.0 credentials in Google Cloud Console and save them as credentials.json. The first time you access Gmail through the server, a browser window prompts you to authorize the application; after that, a token file stores your session.

What permissions does the server request?

The server requests only read access to your Gmail account. No write permissions are requested.

What environment variables are required?

GMAIL_CREDENTIALS_FILE (path to your OAuth credentials file) and GMAIL_TOKEN_FILE (path where the authentication token will be saved).

How is my data stored and secured?

Credentials are stored locally in the token file. Access can be revoked at any time through your Google Account settings. The server uses OAuth2 with automatic token refresh.

Frequently asked questions

What resources and tools does the server provide?

It provides a resource `gmail://inbox/recent` that returns your 10 most recent emails, and a tool `search_emails` that accepts a Gmail search query and optional `max_results` parameter (default 10).

How do I authenticate with Gmail?

You must create OAuth 2.0 credentials in Google Cloud Console and save them as `credentials.json`. The first time you access Gmail through the server, a browser window prompts you to authorize the application; after that, a token file stores your session.

What permissions does the server request?

The server requests only read access to your Gmail account. No write permissions are requested.

What environment variables are required?

`GMAIL_CREDENTIALS_FILE` (path to your OAuth credentials file) and `GMAIL_TOKEN_FILE` (path where the authentication token will be saved).

How is my data stored and secured?

Credentials are stored locally in the token file. Access can be revoked at any time through your Google Account settings. The server uses OAuth2 with automatic token refresh.

Comments

Basic information

More Communication MCP servers

MailStream

Sponge Labs

The first MCP server for physical mail. Give any MCP-compatible AI agent the ability to send real postcards and letters, verify addresses, manage mailing lists and artwork, and track direct mail campaigns. Remote Streama

MCP Headless Gmail Server

baryhuang

A MCP (Model Context Protocol) server that provides get, send Gmails without local credential or token setup.

MCP Teams Server

InditexTech

An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.

383

Mattermost MCP Server

pvev

Mattermost MCP server to enable Claude to interact with Mattermost Workspaces

Modular Outlook MCP Server

ryaker

MCP server for Claude to access Outlook data via Microsoft Graph API

398