Enhanced Gmail MCP Server
About
An MCP server for Gmail, allowing AI assistants to manage emails through natural language.
Details
- Author
- theposch
- GitHub stars
- 20
- Downloads
- 492
- Categories
- Communication, Other, Automation, Security
Jump to
- Send, read, trash, and mark emails as read/unread
- Create, list, and edit draft emails
- List, create, apply/remove, rename, and delete labels
- Create folders, move emails between folders, list folders
- Search emails with Gmail’s advanced query syntax
- Archive, batch archive, list, and restore emails
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Enhanced Gmail MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server by cloning the repository, setting up a virtual environment, and running pip install -e .. You need a Google Cloud project with the Gmail API enabled and OAuth 2.0 credentials. Configure the server in Claude Desktop’s claude_desktop_config.json using the uv command with --creds-file-path and --token-path arguments. You can also test with the MCP Inspector.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"enhanced gmail mcp server": {
"gmail-mcp": {
"command": "python",
"args": [
"-m",
"venv",
".venv"
]
}
}
}
}McpServers
{
"gmail-mcp": {
"command": "python",
"args": [
"-m",
"venv",
".venv"
]
}
}Enhanced Gmail MCP Server
A powerful and feature-rich Model Context Protocol (MCP) server for Gmail integration, written in Python. This server enables AI assistants like Claude to interact with Gmail through natural language, providing comprehensive email management capabilities.
🌟 Key Features
📧 Complete Email Management
- Send emails with customizable subject, content, and recipients - Read and retrieve email content with full metadata - Move emails to trash with confirmation - Mark emails as read/unread - Open emails directly in browser📝 Draft Management
- Create draft emails for later review - List all draft emails - Edit existing drafts🏷️ Advanced Label Management
- List all available labels - Create custom labels - Apply/remove labels from emails - Rename existing labels - Delete unused labels - Search emails by label📁 Folder Organization
- Create new folders (implemented as Gmail labels) - Move emails between folders - List all available folders🔍 Powerful Search & Filtering
- Search emails using Gmail's advanced query syntax - Create, manage, and delete email filters - Filter by sender, recipient, subject, content, and more - Customize search results with flexible parameters🗄️ Archive Management
- Archive emails (remove from inbox without deleting) - Batch archive multiple emails matching search criteria - List all archived emails - Restore archived emails to inbox🚀 Getting Started
Prerequisites
- Python 3.8+ - Google Cloud project with Gmail API enabled - OAuth 2.0 credentialsInstallation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
