MCP server for Gmail integration with OAuth authentication, message search, batch operations, and Google Sheets export
HEALTH ? 85 / Healthy
// readme
@mcp-z/mcp-gmail
MCP server for Gmail integration with OAuth authentication, message search, batch operations, and Google Sheets export
Requires Node.js >=20. The examples use npx, included with npm, to run this server and @mcp-z/cli.
Common uses
- Search and read messages
- Send and reply to emails
- Manage labels and export messages to CSV
Transports
MCP supports stdio and HTTP.
Both the 2025 and 2026-07-28 protocol revisions are served, over either transport, from the same
server. Your client negotiates whichever it speaks. A 2025 client keeps working with no change,
and support for it is not being dropped. The 2026-07-28 revision is stateless, so a client speaking
it sends no initialize handshake and carries no session id.
Stdio
{
"mcpServers": {
"gmail": {
"command": "npx",
"args": ["-y", "@mcp-z/mcp-gmail"]
}
}
}
HTTP
{
"mcpServers": {
"gmail": {
"type": "http",
"url": "http://localhost:9002/mcp",
"start": {
"command": "npx",
"args": ["-y", "@mcp-z/mcp-gmail", "--port=9002"]
}
}
}
}
start is an extension used byโฆ