Log inSubmit server
GMail Manager MCP logo

GMail Manager MCP

by muammar-yacoob

Manage Gmail messages and labels through MCP tools for search, reading, cleanup, organization, and reply drafting.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install GMail Manager MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "muammar-yacoob-gmail-manager-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@spark-apps/gmail-manager-mcp@latest"
      ],
      "env": {
        "GMAIL_OAUTH_PATH": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

muammar-yacoob/GMail-Manager-MCP MCP server connects an MCP client to Gmail through Google OAuth. It supports Gmail query searches, email reading, permanent deletion, bulk deletion, label management, and reply draft generation. Use it when an agent needs to inspect or organize an inbox through natural-language requests, especially for recurring cleanup tasks. Authentication opens a browser and stores access using a Google OAuth keys file.

Use cases

  • Search Gmail for newsletters and promotional messages
  • Delete multiple unwanted emails after reviewing search results
  • Create and apply labels to organize inbox messages
  • Read an email and prepare a reply draft
  • List existing Gmail labels before changing inbox organization

Key features

  • Gmail query-based email search
  • Full email content reading
  • Single and batch email deletion
  • Label creation and assignment
  • Browser-based Gmail OAuth authentication
  • Reply draft generation with Gmail compose URL

Tools12

What GMail Manager MCP lets your agent do. Expand a tool for its parameters.

Verified live~855 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

18/23 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · @spark-apps/gmail-manager-mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads136Package downloads in the last 30 days.
Last commit27d agoMost recent push to the default branch.
Tools exposed12Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How GMail Manager MCP works

What muammar-yacoob/GMail-Manager-MCP MCP server does

muammar-yacoob/GMail-Manager-MCP MCP server exposes Gmail operations to MCP-compatible clients. Its tools cover message discovery, message content, destructive cleanup, label administration, and reply drafting. An agent can search with Gmail query syntax, inspect a message, permanently delete one or many messages, and add or remove labels from individual or grouped messages.

The server also provides a browser-based authentication tool. After access is authorized, an MCP client can use the Gmail-related tools through natural-language instructions. The project is suited to inbox maintenance workflows such as finding newsletters, grouping messages with labels, removing batches of unwanted mail, or preparing a short response draft.

How it works

The server runs as an MCP process and can be started from npm with npx, installed globally, or built from a local checkout. MCP client configuration supplies the command that launches the process. The published package is @spark-apps/gmail-manager-mcp.

Google access uses OAuth. The user creates a Google Cloud project, enables the Gmail API, creates a desktop OAuth client, downloads the credentials file, and authorizes the account in a browser. Searches use Gmail's own query syntax rather than a separate search language. The reply tool generates a brief draft and returns a Gmail compose URL; it does not send the message based on the listed capability.

Setup and configuration

Create the OAuth credentials file as gcp-oauth.keys.json and place it in the current directory or home directory, or set GMAIL_OAUTH_PATH to a custom location.

For Claude Code, the documented command is:

Terminal
claude mcp add gmail-manager -- npx -y @spark-apps/gmail-manager-mcp@latest

Run authentication separately with:

Terminal
npx @spark-apps/gmail-manager-mcp@latest auth

Other MCP clients can launch the package with npx -y @spark-apps/gmail-manager-mcp@latest and provide the OAuth path in their environment configuration. A local installation can be cloned, installed with npm, and launched from its built dist/index.js entry point.

Tools and capabilities

The listed tools provide these operations:

  • search_emails: query Gmail using Gmail query syntax.
  • read_email: retrieve the full content of an email.
  • delete_email: permanently delete one email.
  • batch_delete_emails: permanently delete multiple emails.
  • list_labels: retrieve Gmail labels.
  • create_label and delete_label: manage labels.
  • apply_label, remove_label, and batch_apply_labels: change labels on one or multiple emails.
  • create_reply: generate a short reply draft and a Gmail compose URL.
  • authenticate_gmail: start browser-based Gmail authentication.

Limitations and notes

Permanent deletion is destructive, so an agent should verify search results before calling the deletion tools. The material lists OAuth credentials and Gmail scopes as prerequisites; access is not anonymous. The README names Claude Desktop and Claude Code usage, while the package is described as runnable by other MCP clients through a standard command configuration. Existing credentials may need reauthorization if the required Google scopes change.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GMail Manager MCP

muammar-yacoob/GMail-Manager-MCP is an MCP server that connects compatible AI clients to Gmail through Google OAuth. Its main tools search and read emails, delete messages individually or in batches, manage labels, authenticate Gmail access, and create brief reply drafts with Gmail compose URLs.

Install it with `npx -y @spark-apps/gmail-manager-mcp@latest`, or add the documented Claude Code command. You can also install the npm package globally or clone the repository, run `npm install`, and use the local built entry point.

Authenticate by creating a Google desktop OAuth client, saving the downloaded credentials as `gcp-oauth.keys.json`, and running `npx @spark-apps/gmail-manager-mcp@latest auth`. The authentication flow opens a browser, and `GMAIL_OAUTH_PATH` can specify a custom credentials-file location.

Yes, it can be launched by other MCP clients through the documented command configuration, although the README specifically shows examples for Claude Desktop and Claude Code. Configure the client to run the npm package and provide the OAuth credentials path when needed.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGMail Manager MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/muammar-yacoob-gmail-manager-mcp?style=directory)](https://allmcps.com/mcp/muammar-yacoob-gmail-manager-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/muammar-yacoob-gmail-manager-mcp"><img src="https://allmcps.com/api/badge/muammar-yacoob-gmail-manager-mcp?style=directory" alt="GMail Manager MCP on AllMCPs" /></a>