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 🗝️
🔑 Required before any installation
- 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 gcp-oauth.keys.json:
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
📦 Install from npm registry (Easier ⚡)
npm i -g @spark-apps/gmail-manager-mcp
🏠 Clone and build locally (Safer 🛡️)
git clone https://github.com/muammar-yacoob/GMail-Manager-MCP.git
cd GMail-Manager-MCP
npm install
💻 Terminal Usage
🖥️ Quick Commands
# 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
🔧 Required for MCP client integration
Add to your MCP client config file (Claude Desktop example):
- Windows
%APPDATA%\\Claude\\claude_desktop_config.json - macOS
~/Library/Application Support/Claude/claude_desktop_config.json - Linux
~/.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
🔧 View All 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
🧹 Quick Cleanup
- "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"
⚡ Smart Actions
- "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"
📊 Inbox Insights
- "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 - Buy me one?
💰 Crypto tips welcome - Tip in crypto
🤝 Contributions are welcome - 🍴 Fork, improve, PR!
🎥 Need help? 
Setup Tutorial • 
Join Discord
💖 Sponsor
Your support helps maintain and improve the tool. please consider sponsoring the project.
Made with ❤️ for MCP • Privacy Policy • Terms of Service