Data · Local MCP server

Gmail

Gmail integration with OAuth authentication, message search, batch operations, and Sheets export.

Visit Gmail's website

What the MCP Registry states

The entry as published to the official MCP Registry (read 2026-10-04), latest version.

Registry name
io.github.mcp-z/mcp-gmail
Version
2.3.1
Status
Active
Category
data
Transport
stdio (local process), Streamable HTTP
Package
npm
Published
2026-09-13
Updated
2026-09-13
Publisher
mcp-z (GitHub) · 5 servers with pages here
Listed under
Gmail MCP servers
Website
github.com/mcp-z/mcp-gmail#readme
Source
Registry API entry

Packages

RegistryPackageVersionTransportEnvironment variables
npmruntime: npx@mcp-z/mcp-gmail2.3.1stdioGOOGLE_CLIENT_ID (required), GOOGLE_CLIENT_SECRET (secret), GOOGLE_SERVICE_ACCOUNT_KEY_FILE, AUTH_MODE, HEADLESS, REDIRECT_URI, RESOURCE_STORE_URI, PORT, BASE_URL, LOG_LEVEL
npmruntime: npx@mcp-z/mcp-gmail2.3.1HTTPGOOGLE_CLIENT_ID (required), GOOGLE_CLIENT_SECRET (secret), GOOGLE_SERVICE_ACCOUNT_KEY_FILE, AUTH_MODE, HEADLESS, REDIRECT_URI, DCR_MODE, DCR_VERIFY_URL, DCR_STORE_URI, RESOURCE_STORE_URI, PORT, BASE_URL, LOG_LEVEL

How to connect Gmail

Gmail runs locally from a Node.js package published to the npm registry: @mcp-z/mcp-gmail version 2.3.1. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Node.js; clients usually start it with npx — the usual command is npx -y @mcp-z/mcp-gmail@2.3.1. It reads these environment variables: GOOGLE_CLIENT_ID (required), GOOGLE_CLIENT_SECRET (secret), GOOGLE_SERVICE_ACCOUNT_KEY_FILE, AUTH_MODE, HEADLESS, REDIRECT_URI, RESOURCE_STORE_URI, PORT, BASE_URL and LOG_LEVEL; set them in the client's configuration for this server.

Gmail runs locally from a Node.js package published to the npm registry: @mcp-z/mcp-gmail version 2.3.1. The package starts a local server that speaks MCP over Streamable HTTP; the client then connects to it by URL (the entry names npx as the runtime). It reads these environment variables: GOOGLE_CLIENT_ID (required), GOOGLE_CLIENT_SECRET (secret), GOOGLE_SERVICE_ACCOUNT_KEY_FILE, AUTH_MODE, HEADLESS, REDIRECT_URI, DCR_MODE, DCR_VERIFY_URL, DCR_STORE_URI, RESOURCE_STORE_URI, PORT, BASE_URL and LOG_LEVEL; set them in the client's configuration for this server.

In the mcpServers JSON format that many desktop and editor MCP clients read, the entry looks like this (placeholders in angle brackets):

{
  "mcpServers": {
    "mcp-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-gmail@2.3.1"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<value>",
        "GOOGLE_CLIENT_SECRET": "<secret>",
        "GOOGLE_SERVICE_ACCOUNT_KEY_FILE": "<value>",
        "AUTH_MODE": "<value>",
        "HEADLESS": "<value>",
        "REDIRECT_URI": "<value>",
        "RESOURCE_STORE_URI": "<value>",
        "PORT": "<value>",
        "BASE_URL": "<value>",
        "LOG_LEVEL": "<value>"
      }
    }
  }
}

Derived from the registry entry, not tested here. What the server does, and on what terms, is set by its publisher; check its repository or website before giving it access to your accounts or files. How to add an MCP server to an assistant · Before you connect

More from mcp-z (GitHub)

All 5 →
ServerRunsEndpoint or package
Google DriveGoogle Drive integration with file operations, folder navigation, search, and sharing.Local · stdio, HTTPnpm: @mcp-z/mcp-drive
Google SheetsGoogle Sheets integration with OAuth, spreadsheet management, batch operations, and formatting.Local · stdio, HTTPnpm: @mcp-z/mcp-sheets
OutlookOutlook integration with OAuth, message search, batch operations, and calendar management.Local · stdio, HTTPnpm: @mcp-z/mcp-outlook
PDF GeneratorMCP server for creative PDF generation with full emoji, Unicode, and offline support.Local · stdio, HTTPnpm: @mcp-z/mcp-pdf

More data servers

All 4,395 →
ServerRunsEndpoint or package
Global Metro Power RankingsQuery 4,300+ ranked metros across sixteen dimensions: profiles, search, and head-to-head comparisons.Remote · HTTPrankings.citizenofnowhere.org
GlobalGov — Government Procurement IntelligenceFind the government contracts you can actually bid on, while they are still open. Free, no key.Remote · HTTPfreemcp.globalgov.io
GlobalSource Partners MCP ServerSearch expert emerging-markets research on economics, politics, policy and sovereign risk.Remote · HTTPglobalsourcepartners.com
Glossier MCPGlossier beauty catalog search, products and prices.Local · stdionpm: glossier-mcp
gmapsscraper.ioScrape Google Maps business data from any MCP client — names, phones, emails, websites, ratings.Local · stdionpm: @gmapsscraper/mcp
GnosariAI chatbot that turns conversations into typed records. Create Gnosaris, set fields, read the data.Remote · HTTPmcp.gnosari.com
GoAI Moat Claim VerifierVerify business claims and audit text for unsourced data.Remote · HTTPverifier.mcp.goaimoat.com
GoAI Moat Decision-Maker LookupFind B2B decision makers and verify work emails.Remote · HTTPcontacts.mcp.goaimoat.com