Gmail AutoAuth MCP Server

A Model Context Protocol (MCP) server for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.

Catalog onlyCatalog onlySTDIO

Overview

Gmail AutoAuth MCP Server is a Model Context Protocol (MCP) server that facilitates Gmail integration in Claude Desktop, enabling AI assistants to manage Gmail using natural language interactions.

To use the server, first create a Google Cloud Project and obtain OAuth 2.0 credentials. After setting up, run authentication commands to integrate with your Claude Desktop.

Sends emails with subject, content, and attachments - Reads email messages by ID - Searches emails using various criteria - Lists emails in inbox or custom labels - Manages email states (read/unread, move to label) - User-friendly OAuth2 authentication with automatic browser launch - Supports both Desktop and Web application credentials

Automating email responses in AI applications
Managing email workflows via voice or text commands
Integrating email functionalities into personal assistant software

Add to your AI client

Use these steps to connect Gmail AutoAuth MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "gmail-mcp-server-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gmail-mcp-server-gongrzhe"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "gmail-mcp-server-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gmail-mcp-server-gongrzhe"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "gmail-mcp-server-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gmail-mcp-server-gongrzhe"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "gmail-mcp-server-gongrzhe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gmail-mcp-server-gongrzhe"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gmail-mcp-server-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gmail-mcp-server-gongrzhe"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "gmail-mcp-server-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gmail-mcp-server-gongrzhe"
      ]
    }
  }
}

Developer tools