How do I install the mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GMAIL_MCP_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Server — arthjhon/mcp-gmail-manager

Gmail Model Context Protocol server with recipient allowlist and local audit log.

Local serverstdioPython

What is the MCP Server?

Gmail Model Context Protocol server with recipient allowlist and local audit log.

What the server does

A comprehensive Gmail Model Context Protocol server: 35 tools covering send/preview/confirm, reply, forward, drafts, search, read, attachments, trash, labels, filters, signature, and vacation responder.

Credentials and setup notes

Python ≥ 3.10 - A Google Cloud project with the Gmail API enabled and an OAuth 2.0 client (Desktop type) - A way to forward localhost:8765 to your auth host (typically ssh -L 8765:localhost:8765 user@host)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the MCP Server

{
  "mcpServers": {
    "gmail-manager": {
      "command": "uvx",
      "args": ["mcp-gmail-manager"],
      "env": {
        "GMAIL_MCP_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Python ≥ 3.10 - A Google Cloud project with the Gmail API enabled and an OAuth 2.0 client (Desktop type) - A way to forward localhost:8765 to your auth host (typically ssh -L 8765:localhost:8765 user@host)

Variable	Description	Required
GMAIL_MCP_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use MCP to Group.”
“Use MCP to Drafts.”
“Use MCP to Attachments.”

Frequently asked questions

Gmail Model Context Protocol server with recipient allowlist and local audit log. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.