Data · Local MCP server
Gmail
Gmail integration with OAuth authentication, message search, batch operations, and Sheets export.
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
| Registry | Package | Version | Transport |
|---|---|---|---|
| npmruntime: npx | @mcp-z/mcp-gmail | 2.3.1 | stdio |
| npmruntime: npx | @mcp-z/mcp-gmail | 2.3.1 | HTTP |
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)
| Server | Runs |
|---|---|
| Google DriveGoogle Drive integration with file operations, folder navigation, search, and sharing. | Local · stdio, HTTP |
| Google SheetsGoogle Sheets integration with OAuth, spreadsheet management, batch operations, and formatting. | Local · stdio, HTTP |
| OutlookOutlook integration with OAuth, message search, batch operations, and calendar management. | Local · stdio, HTTP |
| PDF GeneratorMCP server for creative PDF generation with full emoji, Unicode, and offline support. | Local · stdio, HTTP |
More data servers
| Server | Runs |
|---|---|
| Global Metro Power RankingsQuery 4,300+ ranked metros across sixteen dimensions: profiles, search, and head-to-head comparisons. | Remote · HTTP |
| GlobalGov — Government Procurement IntelligenceFind the government contracts you can actually bid on, while they are still open. Free, no key. | Remote · HTTP |
| GlobalSource Partners MCP ServerSearch expert emerging-markets research on economics, politics, policy and sovereign risk. | Remote · HTTP |
| Glossier MCPGlossier beauty catalog search, products and prices. | Local · stdio |
| gmapsscraper.ioScrape Google Maps business data from any MCP client — names, phones, emails, websites, ratings. | Local · stdio |
| GnosariAI chatbot that turns conversations into typed records. Create Gnosaris, set fields, read the data. | Remote · HTTP |
| GoAI Moat Claim VerifierVerify business claims and audit text for unsourced data. | Remote · HTTP |
| GoAI Moat Decision-Maker LookupFind B2B decision makers and verify work emails. | Remote · HTTP |