Skip to main content
Glama
universal-mcp

google-mail-mcp

by universal-mcp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Google-Mail Universal MCP Server

This repository contains an implementation of an Google-Mail Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Google-Mail's tools and services through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Google-Mail directly from agentr.dev. Visit agentr.dev/apps and enable Google-Mail.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Related MCP server: gmail-mcp

Available Tools

The full list of available tools is at ./src/universal_mcp_google_mail/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

  • Python 3.11+ (recommended)

  • uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

  1. Sync Project Dependencies

    uv sync

    This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

  2. Activate the Virtual Environment

    For Linux/macOS:

    source .venv/bin/activate

    For Windows (PowerShell):

    .venv\Scripts\Activate

  3. Start the MCP Inspector

    mcp dev src/universal_mcp_google_mail/server.py

    This will start the MCP inspector. Make note of the address and port shown in the console output.

  4. Install the Application

    mcp install src/universal_mcp_google_mail/server.py

📁 Project Structure

.
├── src/
│   └── universal_mcp_google_mail/
│       ├── __init__.py       # Package initializer
│       ├── server.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.

Generated with MCP CLI — Happy coding! 🚀

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

  • emailA
    dev.primitive

    Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.

    EmailCommunication
    302
  • sebastianall1977-gmail-mcpOAuth
    ai.smithery

    Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…

    CommunicationApp AutomationWorkplace & Productivity
    2
  • AIsa Agent MailAOAuth
    one.aisa

    Your agent needs a mailbox of its own — to receive, thread, draft and send, with attachments, without borrowing your personal inbox or your company's SMTP. **What you can ask for** • "Create an inbox for this agent and tell me its address." • "Read the new messages in this thread and draft a reply." • "Send this message with the attachment and wait for the response." • "Search this inbox for everything from that domain." • "Show delivery metrics and the events on this inbox." **How to use it** Point any MCP client at https://mcp.aisa.one/mail/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: create and delete inboxes, list and read messages, raw message bodies, attachments, threads, drafts and draft attachments, send and reply, message search, inbox events, metrics, and list entries — reads and writes. **Why this rather than the source** A real inbox an agent owns, rather than an SMTP credential it borrows from a human. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the contact elsewhere in the catalogue, then write to them from here — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/sales/mcp finds the person to write to.

    App AutomationEmail
    541
  • AgentMailOAuth
    to.agentmail

    Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.

    EmailCommunication
    2

Related MCP Servers

  • Gmail MCP Server

    cablate
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides comprehensive Gmail integration with LLM processing capabilities, allowing users to read, search, filter emails and handle attachments through the Model Context Protocol.
    9 npm
    2
    MIT

  • gmail-mcp

    dedalus-labs
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that enables full management of Gmail accounts, including messages, threads, labels, and drafts. It leverages the Gmail API to allow searching, sending, and organizing emails via secure OAuth2 authentication.
    MIT

  • Gmail MCP Server

    Imsharad
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides access to Gmail functionality through the Model Context Protocol, allowing LLMs like Claude to interact with your email.
    2
    -

  • Gmail MCP Server

    TechVest-Global
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to manage Gmail through natural language, including search, read, send, label, and draft operations via the Model Context Protocol.
    -