Gmail Plugin MCP Server
About
An MCP server for local machine in Claude Desktop
Details
- License
- MIT
Explore
- 📧 Send and receive emails
- 📥 Read unread messages
- 🗑️ Trash emails
- 📱 Open emails in browser
- 📝 Mark emails as read
- 🔒 Secure OAuth2 authentication
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
Gmail Plugin 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
- Python 3.12 or higher
- Gmail API credentials
- MCP client (like Claude Desktop)
uv pip install -e .
uv pip install -r requirements.txt
uv sync --dev --all-extras
``
3. 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 --creds-file-path`)
- 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
send-email
Send an email
get-unread-emails
Retrieve unread emails
read-email
Read email content
trash-email
Move email to trash
mark-email-as-read
Mark email as read
open-email
Open email in browser
| Tool Name | Description | Required Arguments |
|-----------|-------------|-------------------|
| send-email | Send an email | recipient_id, subject, message |
| get-unread-emails | Retrieve unread emails | None |
| read-email | Read email content | email_id |
| trash-email | Move email to trash | email_id |
| mark-email-as-read | Mark email as read | email_id |
| open-email | Open email in browser | email_id |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gmail plugin mcp server": {
"MCP-Server---Gmail-Plugin-for-Claude-Desktop": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
"."
]
}
}
}
}McpServers
{
"MCP-Server---Gmail-Plugin-for-Claude-Desktop": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
"."
]
}
}
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
2. Install dependencies (choose one method):
```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.
