gmail-mcp

gmail-mcp

2

Enhanced Gmail MCP Server is a powerful tool enabling seamless Gmail integration for AI assistants, supporting comprehensive email management through natural language interaction. Key features include complete email management, draft and label management, and advanced search and filtering.

Enhanced Gmail MCP Server

A powerful and feature-rich server for Gmail integration, enabling AI assistants to interact with Gmail through natural language. Key features include:

🌟 Key Features

  • Complete Email Management: send, read, retrieve, and manage email content and metadata.
  • Draft Management: create, list, and edit email drafts.
  • Advanced Label Management: list, create, apply, rename, and delete labels.
  • Folder Organization: create and manage folders.
  • Powerful Search & Filtering: search emails with advanced syntax and manage filters.
  • Archive Management: archive and restore emails.

🚀 Getting Started

Prerequisites

  • Python 3.8+
  • Enabled Gmail API in Google Cloud
  • OAuth 2.0 credentials

Installation

Clone the repository, set up a virtual environment, and install the package.

Google Cloud Setup

Create a Google Cloud project, enable Gmail API, configure OAuth consent screen, and create OAuth 2.0 credentials.

🔧 Usage

Configure and run with Claude Desktop and test with MCP Inspector.

🔐 Security Considerations

Ensure secure credential management and monitor Google Cloud Console for activity.

🛠️ Architecture

Features a single-file architecture with OAuth2 authentication, error handling, and email parsing.