drio
Open app

Gmail AutoAuth MCP Server

Source

Mirror of

Catalog onlyCatalog onlySTDIO

Overview

Gmail AutoAuth MCP Server is a Model Context Protocol (MCP) server designed for Gmail integration in Claude Desktop, enabling AI assistants to manage Gmail through natural language interactions with auto authentication support.

To use the server, install it via Smithery or manually set up a Google Cloud Project with OAuth 2.0 credentials, then authenticate using the provided commands.

  • Send emails with subject, content, attachments, and recipients - Read email messages by ID - Search emails with various criteria (subject, sender, date range) - List emails in inbox, sent, or custom labels - Mark emails as read/unread - Move emails to different labels/folders - Delete emails - Full integration with Gmail API - Simple OAuth2 authentication flow with auto browser launch - Support for both Desktop and Web application credentials - Global credential storage for convenience
  1. Automating email management tasks through AI
  2. Integrating Gmail functionalities into desktop applications
  3. Enhancing productivity by managing emails via natural language commands

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": {
    "gongrzhe-gmail-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gongrzhe-gmail-mcp-server-mcp-mirror"
      ]
    }
  }
}

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": {
    "gongrzhe-gmail-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gongrzhe-gmail-mcp-server-mcp-mirror"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

Is the server easy to set up?

Yes! The server provides clear installation instructions and supports both automated and manual setups.

Can I use it with any email client?

The server is specifically designed for Gmail and integrates directly with the Gmail API.

What security measures are in place?

OAuth credentials are stored securely, and the server uses offline access for persistent authentication.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1178,"uuid":"c26a766c-c65b-45c0-a9fb-196032760492","name":"GongRzhe_Gmail-MCP-Server","title":"Gmail AutoAuth MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2025-01-28T02:36:22.018Z","updated_at":"2025-02-23T07:12:23.951Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"gmail,auto-auth,mcp-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/GongRzhe_Gmail-MCP-Server","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/e0359e4820b3861a4d7ebab5743e2ccaa2186ab5a58a10d9e5cf0b887aef9494/68747470733a2f2f736d6974686572792e61692f62616467652f40676f6e67727a68652f7365727665722d676d61696c2d6175746f617574682d6d6370","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools