Skip to main content
Glama
Uncommontayo

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.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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
    D
    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
    C
    maintenance
    MCP server that lets AI assistants send, read, and manage Gmail through natural language, including email sending, inbox management, and template-based outreach.
    152
    MIT