Skip to main content
Glama
Gmail MCP Server

Gmail MCP Server

by Uncommontayo

Gmail MCP Server πŸ“§

A high-performance Model Context Protocol (MCP) server that enables AI assistants to interact with Gmail securely.

MCP Python License

✨ Features

  • Smart Email Retrieval: Fetch unread messages with rich metadata.

  • Thread-Aware Drafting: Create replies that maintain conversation context.

  • Secure Authentication: Robust OAuth 2.0 implementation with token management.

  • Enterprise Ready: Structured for scalability and maintainability.

Related MCP server: Gmail AutoAuth MCP Server

πŸ—οΈ Architecture

System Data Flow

graph TD
    User(["πŸ‘€ User"]) <-->|"Natural Language"| Claude(["πŸ€– Claude Desktop"])
    
    subgraph "MCP Server (Local Machine)"
        Claude <-->|"JSON-RPC (stdio)"| Main["src/main.py"]
        Main -->|Dispatch| Handler["src/handlers.py"]
        Handler -->|Call| Client["src/client.py"]
    end
    
    Client <-->|"HTTPS / OAuth 2.0"| Gmail(["☁️ Google Gmail API"])
    
    style User fill:#f9f,stroke:#333
    style Claude fill:#e1f5fe,stroke:#01579b
    style Gmail fill:#fce4ec,stroke:#880e4f

The project follows standard engineering practices:

MLI/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ main.py          # Application Entry Point
β”‚   β”œβ”€β”€ client.py        # Gmail API Client
β”‚   └── handlers.py      # Request Handlers
β”œβ”€β”€ config/              # Configuration & Credentials
β”œβ”€β”€ tests/               # Unit Tests
└── requirements.txt     # Dependencies

πŸš€ Quick Start

1. Prerequisite

  • Python 3.8+

  • Google Cloud Project with Gmail API enabled

2. Installation

# Clone and setup environment
python -m venv .venv
.venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

3. Configuration

  1. Place your Google Cloud credentials.json in config/.

  2. Copy the environment config:

    copy .env.example .env

4. Claude Integration

Add to your Claude Desktop config (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "gmail": {
      "command": "C:\\Path\\To\\MLI\\.venv\\Scripts\\python.exe",
      "args": ["-m", "src.main"],
      "cwd": "C:\\Path\\To\\MLI",
      "env": {
        "CREDENTIALS_PATH": "config/credentials.json",
        "TOKEN_PATH": "config/token.json"
      }
    }
  }
}

πŸ› οΈ Usage

Check Emails:

"Check my unread emails"

Draft Reply:

"Draft a reply to the email from [Name]"

πŸ›‘οΈ Security

  • Credentials are never committed to version control.

  • Tokens are stored locally in config/.

  • Communication happens directly between your machine and Google API.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides AI applications with a toolset for an Artificial Virtual Assistant (AVA) integrated with the Gmail API. It enables users to automate email management and personal tasks through secure Google OAuth authentication.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server enabling AI assistants to manage Gmail through natural language, including sending, reading, searching, labeling, and handling attachments with auto authentication.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for Gmail that allows AI assistants to read, search, compose drafts, send emails, and manage labels with attachment support.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that lets AI assistants send, read, and manage Gmail through natural language, including email sending, inbox management, and template-based outreach.
      131 npm
      MIT