-
securityA
license-
qualityServer for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.
Last updated -
2,386
724
MIT License
Provides comprehensive Gmail inbox management capabilities including email search, reading, bulk deletion, label creation and management, and inbox analytics for organizing and cleaning up email accounts.
Gmail Manager MCP
๐งน Clean your inbox โข ๐ท๏ธ Organize with labels โข ๐๏ธ Bulk delete emails
โจ What It Does
Gmail Manager MCP provides direct access to your Gmail inbox through the Model Context Protocol, allowing you to:
Feature | Description |
Find emails by sender, subject, date, or any Gmail query | |
Get insights about your email patterns and volume | |
Read the full content of an email | |
Create and apply labels to categorize emails automatically | |
Remove old newsletters, notifications, and spam efficiently |
๐ Quick Setup
๐ Prerequisites: Get Gmail Credentials ๐๏ธ
Create New Project ๐
Enable Gmail API ๐ง
Create OAuth client ID (Desktop app type) ๐
Download as
gcp-oauth.keys.json๐ฅNavigate to Data access โ Add or remove scopes โ Enter:
https://mail.google.com/๐Navigate to Test users โ Add your Google email ๐ค
๐ Where to put
For Windows users in WSL:
# Copy from Windows to current directory
cp /mnt/c/Users/YourUsername/gcp-oauth.keys.json ./gcp-oauth.keys.json
General locations:
Current directory:
./gcp-oauth.keys.json(works everywhere)Home directory:
~/gcp-oauth.keys.json(for npx usage)Custom path: Set
GMAIL_OAUTH_PATHenvironment variable
๐ฅ Installation
npm i -g @spark-apps/gmail-manager-mcp
git clone https://github.com/muammar-yacoob/GMail-Manager-MCP.git
cd GMail-Manager-MCP
npm install
๐ป Terminal Usage
# Install globally
npm i -g @spark-apps/gmail-manager-mcp
# Setup authentication (run this first)
npx @spark-apps/gmail-manager-mcp@latest auth
# Test MCP server (for debugging)
npx @modelcontextprotocol/inspector npx @spark-apps/gmail-manager-mcp@latest
โ๏ธ Configure MCP Client
Add to your MCP client config file (Claude Desktop example):
Windows
%APPDATA%\\Claude\\claude_desktop_config.jsonmacOS
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux
~/.config/Claude/claude_desktop_config.json
๐ฆ For NPM Install:
{
"mcpServers": {
"gmail-manager": {
"command": "npx", "args": ["@spark-apps/gmail-manager-mcp@latest"],
"env": { "GMAIL_OAUTH_PATH": "C:\\path\\to\\gcp-oauth.keys.json" }
}
}
}
For Local Development:
{
"mcpServers": {
"gmail-manager": {
"command": "node", "args": ["C:\\path\\to\\GMail-Manager-MCP\\dist\\index.js"]
}
}
}
๐ ๏ธ Available Tools
Tool | Description |
Authenticate Gmail access via web browser | |
Search emails using Gmail query syntax | |
Read the full content of an email | |
Create a draft reply to an email with a smart, context-aware response | |
List all Gmail labels | |
Create a new Gmail label | |
Apply a label to an email | |
Apply labels to multiple emails | |
Remove a label from an email | |
Delete a Gmail label | |
Permanently delete an email | |
Delete multiple emails at once |
๐ฌ Example Commands
"Delete all promotional emails from last 30 days"
"Delete all unread newsletters older than 1 week"
"Delete all 'no-reply' emails from last 3 months"
"Delete all LinkedIn notification emails"
"Delete all password reset emails older than 1 month"
"Delete redundant email chains where I'm CC'd"
"Summarize email with subject: 'last boring meeting'"
"Summarize all emails about 'project deadline'"
"Reply to email about 'project update' saying 'Got it, thanks!'"
"Label all emails from my bank as 'Finance'"
"Create 'Travel' label and move all booking confirmations"
"Find emails with attachments larger than 5MB"
"Show me who sends me the most emails"
"Find all unread emails older than 1 week"
"Show my busiest email days this month"
"Find emails I starred but never replied to"
๐ฑ Support & Contributions
โญ Star the repo & I power up like Mario ๐
โ Devs run on coffee -
๐ฐ Crypto tips welcome - Tip in crypto
๐ค Contributions are welcome - , improve, PR!
๐ฅ Need help? โข
๐ Sponsor
Your support helps maintain and improve the tool. please consider .
Made with โค๏ธ for MCP โข Privacy Policy โข Terms of Service
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Connects Claude Desktop to your Gmail so you can start managing your inbox using natural language. Bulk delete promos & newsletters, organize labels and get useful insights.
Related MCP Servers
- -securityAlicense-qualityA server that allows Claude to search and retrieve emails from your Gmail account, supporting functions like searching emails, retrieving full content of specific emails, and listing recent messages.Last updated -6Apache 2.0
- -securityFlicense-qualityAn integration server that provides Claude Desktop access to Gmail, enabling users to view recent emails and search their Gmail inbox using natural language commands.Last updated -7
- -securityFlicense-qualityConnects Claude with Microsoft Outlook through the Graph API, providing comprehensive email, calendar, folder management, and rules creation capabilities.Last updated -12