Gmail MCP Server

@Imsharad

About Gmail MCP Server

A Gmail Model Context Protocol server for seamless integration with AI assistants

Config

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

{
  "mcpServers": {
    "gmail": {
      "command": "python",
      "args": [
        "-m",
        "src.server"
      ],
      "cwd": "/path/to/gmail-mcp-server"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Gmail MCP Server?

The Gmail MCP Server provides access to Gmail functionality through the Model Context Protocol, allowing LLMs like Claude to interact with your email. It is designed for developers and AI assistants that need to read, search, send, and reply to emails programmatically.

How to use Gmail MCP Server?

Set up a Python virtual environment, install dependencies, enable the Gmail API in Google Cloud Console, and download OAuth 2.0 credentials as credentials.json. Run the server with python -m src.server; the first launch opens a browser for authentication. Afterwards, configure Claude Desktop by adding the server to claude_desktop_config.json with the command python -m src.server and the project directory as the working directory.

Key features of Gmail MCP Server

List emails from your inbox
Search for specific emails
Read email content
Send new emails
Reply to existing emails

Use cases of Gmail MCP Server

An AI assistant reads and summarizes unread emails on demand
A Claude‑powered tool searches for important messages by keyword
Automated reply workflows triggered by LLM prompts
Drafting and sending emails without leaving the chat interface

FAQ from Gmail MCP Server

What is the Gmail MCP Server?

It is an MCP server that gives LLMs like Claude the ability to interact with Gmail – listing, searching, reading, sending, and replying to emails.

How do I set up authentication?

Create a Google Cloud project, enable the Gmail API, and generate OAuth 2.0 credentials (desktop application type). Download the credentials as credentials.json into the project root. On first run, the server opens a browser for authorization and saves the tokens to token.json.

What security considerations are there?

Keep your credentials.json and token.json files secure and never commit them to version control. If you suspect compromise, revoke the credentials in the Google Cloud Console and generate new ones.

What are the Gmail API rate limits?

The Gmail API allows up to 1,000,000,000 quota units per day, with each API method consuming different amounts. For details, refer to Google’s Gmail API Quotas documentation.

How do I configure Claude Desktop to use this server?

Add the server to your claude_desktop_config.json with the command python -m src.server and set the working directory to the project path.

Frequently asked questions

What is the Gmail MCP Server?

It is an MCP server that gives LLMs like Claude the ability to interact with Gmail – listing, searching, reading, sending, and replying to emails.

How do I set up authentication?

Create a Google Cloud project, enable the Gmail API, and generate OAuth 2.0 credentials (desktop application type). Download the credentials as `credentials.json` into the project root. On first run, the server opens a browser for authorization and saves the tokens to `token.json`.

What security considerations are there?

Keep your `credentials.json` and `token.json` files secure and never commit them to version control. If you suspect compromise, revoke the credentials in the Google Cloud Console and generate new ones.

What are the Gmail API rate limits?

The Gmail API allows up to 1,000,000,000 quota units per day, with each API method consuming different amounts. For details, refer to Google’s Gmail API Quotas documentation.

How do I configure Claude Desktop to use this server?

Add the server to your `claude_desktop_config.json` with the command `python -m src.server` and set the working directory to the project path.

Comments

Basic information

More Communication MCP servers

WhatsApp MCP Server (TypeScript/Baileys)

jlucaso1

WhatsApp MCP Server (TypeScript/Baileys)

Socialync

Jack Vitick

Draft, schedule, and publish social media posts to 8 platforms from any AI agent: Facebook, Instagram, X, TikTok, YouTube, LinkedIn, Threads, and Bluesky. 19 tools covering drafting, scheduling, publishing, media upload,