Skip to main content
Glama

GMail Manager MCP

Gmail Manager MCP

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

npm MCP Server MIT GitHub Sponsors

✨ What It Does

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

Feature

Description

Email Search

Find emails by sender, subject, date, or any Gmail query

Inbox Analytics

Get insights about your email patterns and volume

Read & Draft Replies

Read the full content of an email

Smart Organization

Create and apply labels to categorize emails automatically

Bulk Cleanup

Remove 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

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

Tool

Description

Authenticate Gmail

Authenticate Gmail access via web browser

Search Emails

Search emails using Gmail query syntax

Read Email

Read the full content of an email

Create Reply

Create a draft reply to an email with a smart, context-aware response

List Labels

List all Gmail labels

Create Label

Create a new Gmail label

Apply Label

Apply a label to an email

Batch Apply Labels

Apply labels to multiple emails

Remove Label

Remove a label from an email

Delete Label

Delete a Gmail label

Delete Email

Permanently delete an email

Batch Delete Emails

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 MCPPrivacy PolicyTerms of Service

Deploy Server
-
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. 💻 Terminal Usage
        1. ⚙️ Configure MCP Client
          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,697
                    708
                    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 -
                    6
                    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