Gmail Mcp

@klodr

About Gmail Mcp

Gmail MCP server with scope-gated tools (readonly / send / modify), path jails for attachments and downloads, hardened OAuth credentials, and Sigstore-signed releases. Read, search, send, draft, label, filter, and thread Gmail from any MCP-enabled AI assistant.

#gmail #email #oauth #security #mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@klodr/gmail-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Gmail Mcp?

Gmail Mcp reads, searches, sends, drafts, labels, filters, and threads Gmail from any MCP-enabled AI assistant. It wraps the Gmail API with scope-gated tools and in-process safeguards.

How to use Gmail Mcp?

Install globally via npm install -g @klodr/gmail-mcp or invoke directly with npx -y @klodr/gmail-mcp. Authenticate using the auth subcommand with a chosen OAuth scope. Add the server to your MCP client configuration as shown in the README. Requires Node.js 22+.

Key features of Gmail Mcp

Scope-gated tools filtered by granted OAuth scopes.
Path jails restrict attachment and download directories.
Hardened OAuth with file mode 0o600 and TOCTOU defense.
Per-bucket daily and monthly rate limits for sensitive actions.
Opt-in append-only JSONL audit log of tool calls.
Sigstore-signed releases with SLSA attestation and SBOM.

Use cases of Gmail Mcp

Read and search Gmail messages without send permissions.
Send emails using a read-only agent after re-authentication.
Manage labels and filters programmatically.
Draft messages and thread replies via AI assistants.
Log all Gmail tool usage for compliance or debugging.

FAQ from Gmail Mcp

What OAuth scopes are supported?

gmail.readonly, gmail.send, and gmail.modify are supported; tool lists are filtered at startup based on the granted scope.

What are the runtime requirements?

Node.js 22 or higher is required.

Does Gmail Mcp impose rate limits?

Yes, per-bucket daily and monthly caps apply to send, delete, modify, drafts, labels, and filters.

How are attachments secured?

Path jails restrict where the agent can read and write, blocking exfiltration of sensitive files like ~/.ssh/id_rsa.

Is an audit log available?

Yes, an opt-in append-only JSONL log records every tool call (redacted) for auditing purposes.

Frequently asked questions

What OAuth scopes are supported?

`gmail.readonly`, `gmail.send`, and `gmail.modify` are supported; tool lists are filtered at startup based on the granted scope.

What are the runtime requirements?

Node.js 22 or higher is required.

Does Gmail Mcp impose rate limits?

Yes, per-bucket daily and monthly caps apply to send, delete, modify, drafts, labels, and filters.

How are attachments secured?

Path jails restrict where the agent can read and write, blocking exfiltration of sensitive files like `~/.ssh/id_rsa`.

Is an audit log available?

Yes, an opt-in append-only JSONL log records every tool call (redacted) for auditing purposes.

Comments

Basic information

More Communication MCP servers

MailStream

Sponge Labs

The first MCP server for physical mail. Give any MCP-compatible AI agent the ability to send real postcards and letters, verify addresses, manage mailing lists and artwork, and track direct mail campaigns. Remote Streama

Modular Outlook MCP Server

ryaker

MCP server for Claude to access Outlook data via Microsoft Graph API

398

MCP Communicator (Telegram)

qpd-v

An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.

Teams Mcp

floriscornel

MCP server providing comprehensive Microsoft Teams and Graph API access for AI assistants including messaging, search, and user management.

120

Email sending MCP 💌

ykhli

The official MCP server to send emails and interact with Resend

549