Skip to main content
MCP Server
Gmail MCP Server avatar

Gmail MCP Server

by @GongRzhe

Install with VS Code GitHub

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.

Share
gmail-mcp-serverGmailMCPServer
1,131 stars JavaScript MIT Updated: 2026-06-04

Send to Your Agent

Copy this prompt and paste it into Claude, Cursor, or any MCP client to install instantly.

Install the Gmail MCP Server MCP server for me.

Server: Gmail MCP Server
Description: 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.
Install command: npx -y GongRzhe/Gmail-MCP-Server

Environment variables needed:
- Set: up your n8n container to expose a port for authentication (required)
- Configure: a reverse proxy to forward traffic from your domain (e.g., `gmail.gongrzhe.com`) to this port (required)
- Add: an A record in your DNS settings to resolve your domain to your cloud server's IP address (required)
- In: your Google Cloud Console, add your custom domain callback URL (e.g., `https://gmail.gongrzhe.com/oauth2callback`) to th (required)

GitHub: https://github.com/GongRzhe/Gmail-MCP-Server

Please install this MCP server and confirm when ready.

Paste into any AI agent with MCP support — works with Claude Desktop, Cursor, Cline, and more.

Quick Install

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

  1. Open Claude Desktop app
  2. Go to Settings → Developer → Edit Config
  3. Paste the config below into the file
  4. Restart Claude Desktop
{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "GongRzhe/Gmail-MCP-Server"
      ],
      "env": {
        "Set": "value",
        "Configure": "value",
        "Add": "value",
        "In": "value"
      }
    }
  }
}

Add this to your ~/Library/Application Support/Claude/claude_desktop_config.json

Installation Methods

npx Run directly with npx
npx -y GongRzhe/Gmail-MCP-Server
docker Run with Docker
docker run GongRzhe/Gmail-MCP-Server

Tools (1)

execute

Execute Gmail-MCP-Server operations

Environment Variables

Set Required

up your n8n container to expose a port for authentication

Example: value
Configure Required

a reverse proxy to forward traffic from your domain (e.g., `gmail.gongrzhe.com`) to this port

Example: value
Add Required

an A record in your DNS settings to resolve your domain to your cloud server's IP address

Example: value
In Required

your Google Cloud Console, add your custom domain callback URL (e.g., `https://gmail.gongrzhe.com/oauth2callback`) to th

Example: value

Compatibility

Claude Desktop
Cursor
Cline
VS Code
Devin (formerly Windsurf)

About

Gmail AutoAuth MCP Server

Overview

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.

Environment Variables

  • Set: up your n8n container to expose a port for authentication (Required)
  • Configure: a reverse proxy to forward traffic from your domain (e.g., gmail.gongrzhe.com) to this port (Required)
  • Add: an A record in your DNS settings to resolve your domain to your cloud server's IP address (Required)
  • In: your Google Cloud Console, add your custom domain callback URL (e.g., https://gmail.gongrzhe.com/oauth2callback) to th (Required)

Installation

NPX

npx -y GongRzhe/Gmail-MCP-Server

DOCKER

docker run GongRzhe/Gmail-MCP-Server

Related Resources

faithk7-gmail-mcp

MCP Server

Manage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…

MCP Server Builder

Skill

Build high-quality Model Context Protocol (MCP) servers to integrate external APIs and services with AI assistants. Follow best practices for tool design, security, and cross-platform compatibility.

MCP Tool Orchestrator

Prompt

Design and orchestrate complex multi-tool workflows using the Model Context Protocol (MCP). Build intelligent agent systems that coordinate multiple MCP servers for sophisticated automation tasks.

MCP

Glossary

MCP stands for Model Context Protocol. It is an open standard that lets AI clients connect to external tools, data sources, and prompts through a single, consistent interface. Anthropic introduced MCP in late 2024, and it has since been adopted by Claude Desktop, Cursor, Cline, VS Code, Windsurf, and a growing list of community clients. An MCP server is a small program that exposes three things: tools the model can call, resources the client can read, and prompts that help users accomplish common tasks. An MCP client discovers those capabilities and decides when to invoke them. Transport is usually stdio for local servers or Server-Sent Events for remote ones. For developers, MCP removes the need to build a custom integration for every API. You write one server, and any compatible client can use it. For users, it means AI assistants can securely access files, databases, SaaS tools, and web services without each client reinventing the wheel.

kesslerio-attio-mcp-server

MCP Server

Connect AI to your Attio CRM. Manage contacts, companies, deals, and sales pipelines. Create tasks…

Compare LLM Pricing

This server works with Claude, GPT-4o, and other models. Compare API costs side-by-side to find the cheapest option for your workflow.

Browse Pricing Compare Models Cost Calculator