Skip to main content
Glama
Sign In
enesjakozh

Gmail Plugin MCP Server

by sanchisingh01
GitHub
Python
MIT License
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Enables email management including sending, receiving, reading, trashing emails, marking emails as read, and opening emails in browser through Gmail's API with OAuth2 authentication.

Gmail Plugin MCP Server

A powerful MCP server that enables Gmail integration, allowing you to manage emails directly through MCP clients. This plugin provides seamless access to Gmail's core functionality including reading, sending, and managing emails.

Reference: For a sample MCP server implementation using uvx, check out this example.

🎥 Demo

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

✨ Features

  • 📧 Send and receive emails
  • 📥 Read unread messages
  • 🗑️ Trash emails
  • 📱 Open emails in browser
  • 📝 Mark emails as read
  • 🔒 Secure OAuth2 authentication

🚀 Quick Start

Prerequisites

  • Python 3.12 or higher
  • Gmail API credentials
  • MCP client (like Claude Desktop)

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/gmail-plugin.git cd gmail-plugin
  1. Install 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: Install using uv sync (recommended) uv sync --dev --all-extras
  1. Configure your Gmail API credentials:
    • Go to Google Cloud Console
    • Create a new project or select existing one
    • Enable Gmail API
    • Configure OAuth consent screen:
      • Select "External" user type (no publishing required)
      • Go to the Audiences tab : Add your email as a "Test user"
      • Add OAuth scope: https://www.googleapis.com/auth/gmail/modify
    • Create OAuth 2.0 credentials:
      • Choose "Desktop App" as application type
      • Download the JSON credentials file
    • Save the credentials file and note its absolute path (will be used for --creds-file-path)

Configuration

For Development/Unpublished Servers

Add this to your MCP client configuration:

"mcpServers": { "gmail-plugin": { "command": "uv", "args": [ "--directory", "[absolute path to working directory]", "run", "server.py" "--creds-file-path", "[absolute-path-to-credentials-file]", "--token-path", "[absolute-path-to-access-tokens-file]" ] } }
For Published Servers
"mcpServers": { "gmail-plugin": { "command": "uvx", "args": [ "gmail-plugin" ] } }

🛠️ Development

Building and Publishing

  1. Sync dependencies:
uv sync
  1. Build package:
uv build
  1. Publish to PyPI:
uv publish

Debugging

Use the MCP Inspector for debugging:

npx @modelcontextprotocol/inspector uv --directory C:\Users\sanch\Desktop\gmail_plugin\gmail-plugin run gmail-plugin

📚 API Reference

Available Tools

Tool NameDescriptionRequired Arguments
send-emailSend an emailrecipient_id, subject, message
get-unread-emailsRetrieve unread emailsNone
read-emailRead email contentemail_id
trash-emailMove email to trashemail_id
mark-email-as-readMark email as reademail_id
open-emailOpen email in browseremail_id

Available Prompts

Prompt NameDescriptionArguments
manage-emailAct as email administratorNone
draft-emailDraft a new emailcontent, recipient, recipient_email
edit-draftEdit existing email draftchanges, current_draft

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

This server cannot be installed

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

local-only server

The server can only run on the client's local machine because it depends on local resources.

An MCP server that enables Gmail integration, allowing users to manage emails (send, receive, read, trash, mark as read) directly through MCP clients like Claude Desktop.

  1. 🎥 Demo
    1. ✨ Features
      1. 🚀 Quick Start
        1. Prerequisites
        2. Installation
        3. Configuration
      2. 🛠️ Development
        1. Building and Publishing
        2. Debugging
      3. 📚 API Reference
        1. Available Tools
        2. Available Prompts
      4. 🤝 Contributing
        1. 📄 License

          Related MCP Servers

          • @kazuph/mcp-gmail-gas

            kazuph
            A
            security
            A
            license
            A
            quality
            Model Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.
            Last updated -
            3
            7
            8
            JavaScript
            MIT License
            • Apple

          • 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 -
            Python
            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 -
            2
            5
            TypeScript

          • Email Sending MCP

            resend
            A
            security
            F
            license
            A
            quality
            A simple MCP server that enables users to send emails using Resend's API, integrating with tools like Cursor and Claude Desktop for seamless email composition and delivery.
            Last updated -
            1
            6
            321
            TypeScript
            • Apple

          View all related MCP servers

          New MCP Servers

          ID: wz8h3yqihq