Gmail MCP Server

What is Gmail MCP Server?

Gmail MCP Server is a Model Context Protocol server that provides AI-powered analysis and management capabilities for Gmail accounts. It is built exclusively for Gmail using the Gmail API and integrates with Gemini for AI analysis and Google Cloud Storage for email migration.

How to use Gmail MCP Server?

Configure the server in VS Code’s settings.json under the mcp section, providing your Gmail username and password, Gemini API key, and Google Cloud service account credentials. Set up a Python virtual environment, install dependencies with pip install -r requirements.txt, then the server provides a set of tools for managing and analyzing Gmail via the MCP interface.

Key features of Gmail MCP Server

• Gmail-specific integration using the Gmail API
• AI-powered email analysis and priority scoring
• Smart folder creation with custom filtering rules
• Google Cloud Storage migration for emails and attachments
• Batch processing of messages based on criteria
• Thread analysis, label tracking, and email type classification

Use cases of Gmail MCP Server

• Automate inbox analysis to identify priority messages and sender patterns
• Create smart folders to automatically organize emails by rules
• Migrate historical emails and attachments to Google Cloud Storage for archiving
• Perform bulk actions (move, delete, label) on emails matching specific criteria
• Gain insights into email activity, sender trends, and attachment statistics over time

FAQ from Gmail MCP Server

What are the prerequisites for using Gmail MCP Server?

A Gmail account with API access enabled, Google Cloud credentials for the Gmail API and Cloud Storage, a Gemini API key, and Python 3.8 or higher.

How do I configure the server?

Add the MCP configuration to your VS Code settings.json, including prompts for your Gmail username, password, Gemini API key, and Google Cloud service account JSON. The server uses environment variables such as GEMINI_API_KEY, IMAP_HOST, GCS_BUCKET, and various analytics settings.

What tools does Gmail MCP Server provide?

It provides tools to test connection, list labels, search and fetch emails, analyze inbox state, move messages, create smart folders, batch process, migrate emails to GCS, get folder summaries, and retrieve threads.

Does it require a Gmail API key?

It requires Google Cloud credentials for accessing the Gmail API and Google Cloud Storage, not a separate API key. The Gmail account username and password are used for authentication.

What is the role of the Gemini API?

The Gemini API enables AI-powered analysis of email patterns, priority scoring, and inbox insights, as configured via the GEMINI_API_KEY environment variable.