Log inSubmit server
Sebastianall1977 Gmail MCP logo

Sebastianall1977 Gmail MCP

Manage Gmail messages, threads, labels, drafts, settings, and mailbox history through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Sebastianall1977 Gmail 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": {
    "sebastianall1977-gmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shinzolabs/gmail-mcp"
      ],
      "env": {
        "CLIENT_ID": "YOUR_VALUE_HERE",
        "CLIENT_SECRET": "YOUR_VALUE_HERE",
        "REFRESH_TOKEN": "YOUR_VALUE_HERE",
        "AUTH_SERVER_PORT": "YOUR_VALUE_HERE",
        "GMAIL_CREDENTIALS_PATH": "YOUR_VALUE_HERE",
        "GMAIL_OAUTH_PATH": "YOUR_VALUE_HERE",
        "MCP_CONFIG_DIR": "YOUR_VALUE_HERE",
        "PORT": "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.

Automated check passed— started and listed 64 tools correctly (29d ago).

Overview

sebastianall1977-gmail-mcp MCP server connects MCP clients to the Gmail API for reading, sending, drafting, organizing, and configuring mail. It uses Google OAuth 2.0 credentials, with local and Smithery-based remote installation options. Reach for it when an agent needs to search messages, work with threads or labels, manage drafts, or change supported Gmail settings. Node.js 18+ is required for the simplest local installation.

Use cases

  • Search and retrieve Gmail messages
  • Create and send email drafts
  • Apply labels to messages and threads
  • Manage Gmail forwarding and vacation settings
  • Monitor mailbox changes

Key features

  • Message, attachment, and profile access
  • Email sending and draft management
  • Message and thread label operations
  • Gmail label creation and configuration
  • Mailbox watch controls
  • IMAP, POP, forwarding, vacation, and language settings

Tools64

What Sebastianall1977 Gmail MCP lets your agent do. Expand a tool for its parameters.

Verified live~6.9k 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 2d ago

Recent health check succeeded.

21/21 checks healthy over the last 90d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @shinzolabs/gmail-mcp (npm)

Adoption & maintenance

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

npm downloads3.1kPackage downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed64Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Sebastianall1977 Gmail MCP works

What sebastianall1977-gmail-mcp does

sebastianall1977-gmail-mcp MCP server exposes Gmail operations through the Model Context Protocol. It connects an MCP client to a user's Gmail account and supports message retrieval, sending, deletion, trash management, label changes, thread operations, and draft workflows.

The available API surface also includes mailbox profile access, attachment retrieval, mailbox watch controls, and history-related Gmail functionality. Agents can create, update, inspect, and delete labels, including label configuration such as visibility and color where supported by Gmail. Settings tools cover auto-forwarding, IMAP, POP, vacation responder, and language preferences.

How it works

Authentication uses Google OAuth 2.0. An organization first creates a Google Cloud project, enables the Gmail API, and creates a desktop OAuth client. The OAuth key file is stored locally, then each user runs the authentication command to approve access and obtain a refresh token.

The server can run locally through npx or from a source build. Local MCP clients start it with either the package command or the generated Node.js entry point. A remote deployment can use Smithery CLI and pass the Google client ID, client secret, and user refresh token during setup. The README also references Smithery SDK boilerplate for developers building their own agent application.

Setup and configuration

For local use, install Node.js 18 or newer. Building from source additionally requires pnpm. Create the OAuth key file at ~/.gmail-mcp/gcp-oauth.keys.json, then run npx @shinzolabs/gmail-mcp auth and complete the browser-based consent flow. By default, user credentials are written to ~/.gmail-mcp/credentials.json.

The main configuration paths can be changed with MCP_CONFIG_DIR, GMAIL_OAUTH_PATH, and GMAIL_CREDENTIALS_PATH. Remote operation requires CLIENT_ID, CLIENT_SECRET, and REFRESH_TOKEN. AUTH_SERVER_PORT controls the temporary OAuth server, while PORT controls Streamable HTTP transport. Telemetry is enabled by default and can be controlled with TELEMETRY_ENABLED.

Tools and capabilities

sebastianall1977-gmail-mcp MCP server includes tools for:

  • Listing and retrieving messages, threads, labels, drafts, and attachments.
  • Sending messages and drafts, creating or updating drafts, and deleting drafts.
  • Applying or removing labels on individual messages, batches, or threads.
  • Moving messages and threads to or from trash, or permanently deleting them.
  • Creating, updating, partially updating, listing, and deleting labels.
  • Reading and changing auto-forwarding, IMAP, POP, vacation responder, and language settings.
  • Getting the current Gmail profile and starting or stopping mailbox watch notifications.

These operations can support workflows such as triaging mail, preparing replies as drafts, applying labels to matching messages, and changing account settings through an agent.

Limitations and notes

The server requires access to a Google Cloud OAuth client and user authorization; it is not usable without Gmail API credentials. Remote connections require the refresh token and client credentials to be supplied separately.

Destructive operations are available, including permanent message or thread deletion and label deletion, so client-side confirmation may be appropriate before invoking them.

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 Sebastianall1977 Gmail MCP

sebastianall1977-gmail-mcp is an MCP server that connects AI clients to the Gmail API. Its main tools list, read, send, draft, label, modify, delete, and organize messages and threads, while also managing Gmail labels, attachments, mailbox watches, drafts, and supported account settings through Google OAuth.

Install it locally with Node.js 18+ and add an `npx @shinzolabs/gmail-mcp` server entry to the MCP client configuration. You can also build from source with pnpm or install a remote instance through Smithery CLI.

Authenticate it by enabling the Gmail API in Google Cloud, creating a desktop OAuth client, saving the OAuth keys file, and running `npx @shinzolabs/gmail-mcp auth`. The browser flow produces user credentials and a refresh token.

Yes. It can be configured in an MCP client that supports standard MCP servers, including Cursor, using the documented local `npx` command or a remote Streamable HTTP deployment.

Related MCP servers

All in Communication 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 PreviewSebastianall1977 Gmail MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/sebastianall1977-gmail-mcp?style=directory)](https://allmcps.com/mcp/sebastianall1977-gmail-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/sebastianall1977-gmail-mcp"><img src="https://allmcps.com/api/badge/sebastianall1977-gmail-mcp?style=directory" alt="Sebastianall1977 Gmail MCP on AllMCPs" /></a>