Skip to main content
Glama

GMail Manager MCP

Gmail Manager MCP

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

✨ What It Does

Gmail Manager MCP gives Claude Desktop direct access to your Gmail inbox, allowing you to:

FeatureDescription
SearchFind emails by sender, subject, date, or any Gmail query
AnalyticsGet insights about your email patterns and volume
ReadRead the full content of an email
OrganizeCreate and apply labels to categorize emails automatically
CleanupRemove old newsletters, notifications, and spam efficiently

🚀 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 accessAdd or remove scopes → Enter: https://mail.google.com/ 🔓
  6. Navigate to Test users → Add your Google email 👤

📁 Where to put gcp-oauth.keys.json:

  • If using npm (npx): Place it in your home directory
    Windows: %USERPROFILE% • macOS/Linux: ~/
  • If running locally from source: Place it in the project root (same folder as package.json)
  • Or set a custom path: Define GMAIL_OAUTH_PATH in your Claude Desktop config to point to the file

📥 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

⚙️ Configure Claude Desktop

Add to your Claude Desktop config file:

  • 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

ToolDescription
AuthAuthenticate Gmail access via web browser
SearchSearch emails using Gmail query syntax
ReadRead the full content of an email
LabelsList all Gmail labels
CreateCreate a new Gmail label
ApplyApply a label to an email
Batch ApplyApply labels to multiple emails
UnlabelRemove a label from an email
RemoveDelete a Gmail label
DeletePermanently delete an email
Batch DeleteDelete 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'"
  • "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?
🤝 Contributions are welcome - 🍴 Fork, improve, PR!
🎥 Need help? Setup Tutorial Join Discord

Your support helps maintain and improve the tool. please consider sponsoring the project.


Made with ❤️ for Claude DesktopPrivacy PolicyTerms of Service

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

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.

  1. ✨ What It Does
    1. 🚀 Quick Setup
      1. 📋 Prerequisites: Get Gmail Credentials 🗝️
    2. 📥 Installation
      1. ⚙️ Configure Claude Desktop
        1. 🛠️ Available Tools
          1. 💬 Example Commands
            1. 🌱 Support & Contributions
              1. 💖 Sponsor

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  Server 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,698
                  657
                  MIT License
                  • Linux
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A 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 -
                  5
                  Apache 2.0
                • -
                  security
                  F
                  license
                  -
                  quality
                  An 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
                • -
                  security
                  F
                  license
                  -
                  quality
                  Connects Claude with Microsoft Outlook through the Graph API, providing comprehensive email, calendar, folder management, and rules creation capabilities.
                  Last updated -
                  12
                  • Linux
                  • Apple

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/muammar-yacoob/GMail-Manager-MCP'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server