Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Gmail Plugin MCP Server
  • Chrome Debug MCP Server
  • Snyk MCP Server
  • Phrases MCP Server
  • Xano MCP Server for Smithery
Back to MCP Servers
Gmail MCP Server

Gmail MCP Server

Public
Quantum-369/Gmail-mcp-server

Powerful Model Context Protocol server enabling seamless Gmail integration with features for reading, sending, searching, managing emails, handling attachments, real-time monitoring, and multi-account support.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with Gmail MCP Server

MCP Server

Unlock the full potential of Gmail MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Gmail MCP Server

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

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Gmail Plugin MCP Server
    Gmail Plugin MCP Server

    Enables seamless Gmail integration via Model Context Protocol, allowing MCP clients to securely send...

    Added May 30, 2025
  • Chrome Debug MCP Server
    Chrome Debug MCP Server

    Model Context Protocol server enabling advanced browser automation with Playwright, featuring multi-...

    13 tools
    Added May 30, 2025
  • Snyk MCP Server
    Snyk MCP Server

    Standalone Model Context Protocol server enabling security vulnerability scanning of GitHub/GitLab r...

    Added May 30, 2025
  • Phrases MCP Server
    Phrases MCP Server

    Efficient MCP (Model Context Protocol) server for managing inspirational phrases with full CRUD capa...

    6 tools
    Added May 30, 2025
  • Xano MCP Server for Smithery
    Xano MCP Server for Smithery

    Model Context Protocol server enabling seamless integration between Claude AI and Xano databases wit...

    Added May 30, 2025