Gmail Manager MCP

🧹 Clean your inbox • 🏷️ Organize with labels • 🗑️ Bulk delete emails

👁 npm
👁 MCP Server
👁 MIT
👁 GitHub Sponsors
👁 Report Bug
👁 GitHub Stars

✨ What It Does

Gmail Manager MCP provides direct access to your Gmail inbox through the Model Context Protocol, allowing you to:

Related MCP server: Gmail MCP Server

🚀 Quick Setup

📋 Prerequisites: Get Gmail Credentials 🗝️

1. Create New Project 📁

2. Enable Gmail API 📧

3. Create OAuth client ID (Desktop app type) 🔐

4. Download as gcp-oauth.keys.json 📥

5. Navigate to Data access → Add or remove scopes → Enter: https://mail.google.com/ 🔓

6. 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_PATH environment 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.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

💬 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 - 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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• apply_labelB
• authenticate_gmailA
• batch_apply_labelsC
• batch_delete_emailsB
• create_labelB
• create_replyB
• delete_emailB
• delete_labelC