Gmail MCP Server

Enables AI assistants to interact with Gmail through natural language for comprehensive email management.

Local serverstdioPython★ 19

What is the Gmail MCP Server?

Enables AI assistants to interact with Gmail through natural language for comprehensive email management.

What it actually does

A powerful and feature-rich Model Context Protocol (MCP) server for Gmail integration, written in Python. This server enables AI assistants like Claude to interact with Gmail through natural language, providing comprehensive email management capabilities.

Configuration

  • Python 3.8+ - Google Cloud project with Gmail API enabled - OAuth 2.0 credentials

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

How to install the Gmail MCP Server

{
  "mcpServers": {
    "gmail": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/gmail-mcp",
        "run",
        "gmail",
        "--creds-file-path",
        "/absolute/path/to/credentials.json",
        "--token-path",
        "/absolute/path/to/tokens.json"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.8+ - Google Cloud project with Gmail API enabled - OAuth 2.0 credentials

Example prompts to try

  • “Use Gmail to Prerequisites.”
  • “Use Gmail to Installation.”
  • “Use Gmail to Configuration.”

Frequently asked questions

Gmail MCP provides complete email management (send, read, trash), draft management (create, edit), advanced label management (list, create, apply), powerful search & filtering, and archive management.