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.

A
license - permissive license
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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.
    192
    MIT

View all related MCP servers

Related MCP Connectors

  • Shipmail MCP server for AI agent custom-domain email inboxes with REST API and webhooks.

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Uncommontayo/MLI-MCP-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server