MCP Server Gmail Plugin For Claude Desktop

🚀 Gmail Plugin MCP Server

A powerful MCP server supporting Gmail integration, allowing you to directly manage emails through the MCP client. This plugin provides seamless access to Gmail's core functions, including reading, sending, and managing emails.

💡 Reference: Check out this example for an example of an MCP server implementation using uvx.

🎥 Demo

https://github.com/user-attachments/assets/df9e86cf-1f6b-4265-9c68-b3ed88103d1f

✨ Features

• 📧 Send and receive emails
• 📥 Read unread messages
• 🗑️ Delete emails
• 📱 Open emails in the browser
• 📝 Mark emails as read
• 🔒 Authenticate using OAuth2

🚀 Quick Start

Prerequisites

• Python 3.12 or higher
• Gmail API credentials
• MCP client (e.g., Claude Desktop)

Installation

1. Clone the repository:

git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin

2. Install the dependencies (choose one method):

# Method 1: Install in editable mode
uv pip install -e .

# Method 2: Install using requirements.txt
uv pip install -r requirements.txt

# Method 3: Recommended, use uv sync
uv sync --dev --all-extras

3. Configure Gmail API credentials:
   • Visit Google Cloud Console
   • Create a new project or select an existing one
   • Enable the Gmail API
   • Configure the OAuth consent screen:
     • Select the "External" user type (no need to publish)
     • Go to the Audience tab: Add your email as a "Test user"
     • Add the OAuth scope: https://www.googleapis.com/auth/gmail/modify
   • Create OAuth 2.0 credentials:
     • Select "Desktop app" as the application type
     • Download the JSON credentials file
   • Save the credentials file and note its absolute path (to be used for --creds-file-path)

Configuration

For Development/Unpublished Servers

Add the following to your MCP client configuration:

# Method 1: Install in editable mode
uv pip install -e .

# Method 2: Install using requirements.txt
uv pip install -r requirements.txt

# Method 3: Recommended, use uv sync
uv sync --dev --all-extras

For Published Servers

Add the following to app.py:

if __name__ == "__main__":
    app.run(debug=True)

🛠️ Development

Build and Publish

1. Run the following in the project root directory:

uv run build

2. Find the generated files in the build directory.

Debugging

Add the following debug logs to app.py:

from logging.config import dictConfig

# Configure logging
dictConfig({
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'default': {
            'format': '[%(asctime)s] %(levelname)s in %(module)s: %(message)s',
        },
    },
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'formatter': 'default',
            'level': 'DEBUG',
        },
    },
    'root': {
        'level': 'INFO',
        'handlers': ['console'],
    },
})

📋 API Reference

Tools

Example

In app.py:

@app.route('/')
def home():
    return "Welcome to the Gmail Plugin MCP Server!"

🤝 Contributing

1. Fork the project repository.
2. Create a feature branch: git checkout -b feature/your-feature
3. Commit your changes: git commit -m 'Add new feature'
4. Push to your fork: git push origin feature/your-feature
5. Create a pull request.

📄 License

This project is licensed under the MIT License.