Gmail
Gmail integration with OAuth authentication, message search, batch operations, and…
- Runs
- Locally or Remotely
- Version
- 2.4.1
- Listing updated
- 4 days ago
About Gmail
Gmail is an MCP server for communication. It can run locally on your machine or as a hosted remote server.
Gmail integration with OAuth authentication, message search, batch operations, and Sheets export
Install
Run in a terminal
claude mcp add mcp-gmail --env GOOGLE_CLIENT_ID='<GOOGLE_CLIENT_ID>' --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' -- npx -y @mcp-z/mcp-gmailAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-gmail": {
"command": "npx",
"args": [
"-y",
"@mcp-z/mcp-gmail"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-gmail": {
"command": "npx",
"args": [
"-y",
"@mcp-z/mcp-gmail"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-gmail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mcp-z/mcp-gmail"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-gmail": {
"command": "npx",
"args": [
"-y",
"@mcp-z/mcp-gmail"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-gmail": {
"command": "npx",
"args": [
"-y",
"@mcp-z/mcp-gmail"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Configuration
GOOGLE_CLIENT_IDGoogle OAuth client ID (required for OAuth authentication modes)RequiredGOOGLE_CLIENT_SECRETGoogle OAuth client secret (optional for public clients)GOOGLE_SERVICE_ACCOUNT_KEY_FILEPath to service account JSON key file (required for service-account auth mode)AUTH_MODEAuthentication modeHEADLESSDisable browser auto-open, return auth URL instead (true/false)REDIRECT_URIOAuth redirect URI (optional, default: ephemeral loopback)RESOURCE_STORE_URIResource store URI for CSV export files (file://)PORTHTTP server port (overrides --port)BASE_URLBase URL for HTTP transport (used for OAuth/DCR endpoints and file links)LOG_LEVELLogging levelGOOGLE_CLIENT_IDGoogle OAuth client ID (required for OAuth authentication modes)RequiredGOOGLE_CLIENT_SECRETGoogle OAuth client secret (optional for public clients)GOOGLE_SERVICE_ACCOUNT_KEY_FILEPath to service account JSON key file (required for service-account auth mode)AUTH_MODEAuthentication modeHEADLESSDisable browser auto-open, return auth URL instead (true/false)REDIRECT_URIOAuth redirect URI (optional, default: ephemeral loopback)DCR_MODEDynamic Client Registration modeDCR_VERIFY_URLExternal verification endpoint URL (required for external DCR mode)DCR_STORE_URIDCR client storage URI (for self-hosted DCR mode)RESOURCE_STORE_URIResource store URI for CSV export files (file://)PORTHTTP server port (overrides --port)BASE_URLBase URL for HTTP transport (used for OAuth/DCR endpoints and file links)LOG_LEVELLogging level
Gmail FAQ
How do I add Gmail to Claude Code?
Run this command in your terminal: claude mcp add mcp-gmail --env GOOGLE_CLIENT_ID='<GOOGLE_CLIENT_ID>' --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' -- npx -y @mcp-z/mcp-gmail
What are the best alternatives to Gmail?
The closest alternatives to Gmail are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Gmail

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity