Skip to main content

A Universal MCP Application: universal_mcp_google_mail

Project description

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

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! 🚀

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

universal_mcp_google_mail-0.1.6.tar.gz (149.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

universal_mcp_google_mail-0.1.6-py3-none-any.whl (20.8 kB view details)

Uploaded Python 3

File details

Details for the file universal_mcp_google_mail-0.1.6.tar.gz.

File metadata

File hashes

Hashes for universal_mcp_google_mail-0.1.6.tar.gz
Algorithm Hash digest
SHA256 7276996a77a7540388d24ce88c5a786923ee5d51104e14053bab1e57c2e103ed
MD5 84b71a282dca98dd065d565cf7bf9b03
BLAKE2b-256 7128b9ff151ad4352a26cdb9706edbcccb2bb2db09d69db28bf7418169b116b4

See more details on using hashes here.

File details

Details for the file universal_mcp_google_mail-0.1.6-py3-none-any.whl.

File metadata

File hashes

Hashes for universal_mcp_google_mail-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 b990dab3d1ea868d039b3af5f9810c8955fb2ca1e7dd0df60af3f3edf10b6434
MD5 ca6b1b103e5f66ac82a6bcc932d8bbba
BLAKE2b-256 553dd0536dd80d3d7394fe8c683c972eb8eedd1e086e67df19a03939df3934db

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page