Skip to main content
Glama
enesjakozh

Gmail MCP Server

by Quantum-369
GitHub
Python
Apache 2.0
16
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Gmail MCP Server

smithery badge

A powerful and flexible Gmail integration server built using the MCP (Message Control Protocol) framework. This server provides a robust interface to interact with Gmail APIs, offering functionality for reading, sending, and managing emails programmatically.

Features

  • Read emails from multiple Gmail accounts

  • Send emails with attachments

  • Search emails with advanced query options

  • Download email attachments

  • Handle email conversations and threads

  • Real-time email monitoring

  • Support for multiple Gmail accounts

Prerequisites

Before running the Gmail MCP server, ensure you have the following:

  1. Python 3.12 or higher

  2. Google Cloud Project with Gmail API enabled

  3. OAuth 2.0 Client ID credentials

  4. Required Python packages (specified in pyproject.toml)

Installation

Installing via Smithery

To install Gmail Integration Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude

  1. Clone the repository:

git clone <your-repository-url> cd gmail-mcp-server

  1. Create and activate a virtual environment:

python -m venv venv # On Windows venv\Scripts\activate # On Unix/MacOS source venv/bin/activate

  1. Install dependencies:

pip install .

Setup Google Cloud Project

  1. Go to the Google Cloud Console

  2. Create a new project or select an existing one

  3. Enable the Gmail API for your project

  4. Create OAuth 2.0 credentials:

    • Go to "APIs & Services" > "Credentials"

    • Click "Create Credentials" > "OAuth client ID"

    • Choose "Desktop app" as application type

    • Download the client configuration file

  5. Rename the downloaded file to client_secret.json and place it in the project root directory

Configuration

  1. Set up email identifiers in gmail_token_creator.py:

email_identifier = 'your.email@gmail.com' # Change this for each account

  1. Run the token creator to authenticate your Gmail accounts:

python gmail_token_creator.py

  1. Repeat the process for each Gmail account you want to integrate

Server Structure

  • gmail_server.py: Main MCP server implementation

  • gmail_api.py: Gmail API interaction functions

  • google_apis.py: Google API authentication utilities

  • Supporting files:

    • read_emails.py: Email reading functionality

    • search_emails.py: Email search functionality

    • send_emails.py: Email sending functionality

Usage

Starting the Server

python gmail_server.py

Available Tools

  1. Send Email:

await send_gmail( email_identifier="your.email@gmail.com", to="recipient@example.com", subject="Test Subject", body="Email body content", attachment_paths=["path/to/attachment"] )

  1. Search Emails:

await search_email_tool( email_identifier="your.email@gmail.com", query="from:someone@example.com", max_results=30, include_conversations=True )

  1. Read Latest Emails:

await read_latest_emails( email_identifier="your.email@gmail.com", max_results=5, download_attachments=False )

  1. Download Attachments:

await download_email_attachments( email_identifier="your.email@gmail.com", msg_id="message_id", download_all_in_thread=False )

Security Considerations

  • Store client_secret.json securely and never commit it to version control

  • Keep token files secure and add them to .gitignore

  • Use environment variables for sensitive information

  • Regularly rotate OAuth credentials

  • Monitor API usage and set appropriate quotas

Error Handling

The server includes comprehensive error handling and logging:

  • Logs are written to gmail_mcp.log

  • Both file and console logging are enabled

  • Detailed error messages for debugging

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Commit your changes

  4. Push to the branch

  5. Create a Pull Request

License

Apachelicense2.0

Support

For issues and feature requests, please use the GitHub issue tracker.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables interaction with Gmail through the Gmail API to read, send, and manage emails. Supports multiple Gmail accounts with real-time monitoring and advanced features for email search and attachment handling.

  1. Features
    1. Prerequisites
      1. Installation
        1. Installing via Smithery
      2. Setup Google Cloud Project
        1. Configuration
          1. Server Structure
            1. Usage
              1. Starting the Server
              2. Available Tools
            2. Security Considerations
              1. Error Handling
                1. Contributing
                  1. License
                    1. Support

                      Related Resources

                      Related MCP Servers

                      • Gmail MCP Server

                        jmonsellier
                        -
                        security
                        A
                        license
                        -
                        quality
                        Integrates with Gmail to enable sending, reading, drafting, and managing emails via the Model Context Protocol (MCP), allowing users to interact with email tasks through automated client prompts.
                        Last updated -
                        2
                        GPL 3.0

                      • Systemprompt MCP Gmail Server

                        Ejb503
                        -
                        security
                        F
                        license
                        -
                        quality
                        Enables users to manage Gmail accounts using AI agent-assisted operations via an MCP protocol, supporting email search, reading, deletion, and sending with a voice-powered interface.
                        Last updated -
                        11
                        10

                      • Gmail MCP Server

                        cablate
                        -
                        security
                        A
                        license
                        -
                        quality
                        Provides comprehensive Gmail integration with LLM processing capabilities, allowing users to read, search, filter emails and handle attachments through the Model Context Protocol.
                        Last updated -
                        8
                        1
                        MIT License

                      • Gmail MCP

                        shinzo-labs
                        A
                        security
                        A
                        license
                        A
                        quality
                        Manage your emails effortlessly with a standardized interface for drafting, sending, retrieving, and organizing messages. Streamline your email workflow with complete Gmail API coverage, including label and thread management.
                        Last updated -
                        64
                        133
                        36
                        MIT License
                        • Apple
                        • Linux

                      View all related MCP servers

                      Appeared in Searches

                      New MCP Servers

                      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/Quantum-369/Gmail-mcp-server'

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