# muammar-yacoob/GMail-Manager-MCP [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/muammar-yacoob/GMail-Manager-MCP#readme  
**GitHub Stars:** 10  
**npm Downloads (last month):** 136  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/muammar-yacoob-gmail-manager-mcp

## Description
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.

## Tools
Capabilities this server exposes over MCP:

- **search_emails** — Search emails using Gmail query syntax
- **read_email** — Read the full content of an email
- **delete_email** — Permanently delete an email
- **batch_delete_emails** — Delete multiple emails at once
- **list_labels** — List all Gmail labels
- **create_label** — Create a new Gmail label
- **delete_label** — Delete a Gmail label
- **apply_label** — Apply a label to an email
- **remove_label** — Remove a label from an email
- **batch_apply_labels** — Apply labels to multiple emails at once
- **create_reply** — Generate a brief, natural reply draft and provide Gmail compose URL
- **authenticate_gmail** — Authenticate Gmail access via web browser (opens browser automatically)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "gmail-manager-mcp": {
    "command": "npx",
    "args": ["-y","@spark-apps/gmail-manager-mcp@latest"],
    "env": {
      "GMAIL_OAUTH_PATH": ""
    }
  }
}
```

**Requires environment variables:** `GMAIL_OAUTH_PATH` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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:

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

Run authentication separately with:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/muammar-yacoob-gmail-manager-mcp/readme_