Gmail AutoAuth

v1.0.0Communicationstable

Enables AI assistants to manage Gmail through natural language interactions, supporting email operations (send, read, search, draft), comprehensive attachment handling (send, receive, download), label management, filters, and batch operations with au

gmail-autoauth-mcp-servermcpai-integration
Share:
1,118
Stars
0
Downloads
0
Weekly
0/5

What is Gmail AutoAuth?

Gmail AutoAuth is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to manage gmail through natural language interactions, supporting email operations (send, read, search, draft), comprehensive attachment handling (send, receive, download), label...

Enables AI assistants to manage Gmail through natural language interactions, supporting email operations (send, read, search, draft), comprehensive attachment handling (send, receive, download), label management, filters, and batch operations with au

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables AI assistants to manage Gmail through natural langua

Use Cases

Send, read, and search emails using natural language.
Manage attachments, labels, and email filters.
Perform batch email operations with AI assistance.
GongRzhe

Maintainer

LicenseMIT License
Languagejavascript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx gmail-autoauth-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Gmail AutoAuth

Gmail AutoAuth is an MCP server that enables AI assistants to manage Gmail through natural language, supporting email operations like send, read, search, draft management, attachments, labels, and batch operations. Connect it to Claude to automate your email workflow with AI assistance.

Prerequisites

  • Node.js 18+ installed
  • An MCP client such as Claude Desktop or Cursor
  • A Google account with Gmail enabled
  • Google OAuth 2.0 credentials or app-specific password
1

Install Gmail AutoAuth Server

Install the server using npx.

npx gmail-autoauth-mcp-server
2

Set Up Google OAuth Credentials

Create OAuth 2.0 credentials in Google Cloud Console. Download the credentials JSON file and set the path as an environment variable.

3

Register with Your MCP Client

Add the server to your claude_desktop_config.json.

{
  "mcpServers": {
    "gmail-autoauth": {
      "command": "npx",
      "args": ["gmail-autoauth-mcp-server"]
    }
  }
}
4

Authenticate with Gmail

The first time you use the server, it will prompt for Gmail authentication. Follow the OAuth flow to grant the MCP server access to your Gmail account.

5

Restart Your MCP Client

Restart Claude Desktop or your MCP client after authentication.

6

Test Gmail Operations

Ask Claude to show recent emails, compose a draft, or search for messages. Verify that Gmail operations work correctly.

Gmail AutoAuth Examples

Client Configuration Example

Add this to your claude_desktop_config.json mcpServers section.

{
  "mcpServers": {
    "gmail-autoauth": {
      "command": "npx",
      "args": ["gmail-autoauth-mcp-server"]
    }
  }
}

Prompts to Try

Use these prompts to manage Gmail through Claude.

- Show me my last 10 unread emails.
- Search for emails from [sender] about [topic] and summarize them.
- Help me draft a professional reply to [email address] and send it.
- Organize my emails by moving messages to specific labels.

Troubleshooting Gmail AutoAuth

Gmail authentication fails or credential errors occur

Verify that your Google OAuth credentials are correctly set in environment variables. Check that the credentials have Gmail API scopes enabled. Generate new credentials if needed in Google Cloud Console.

Claude cannot read or send emails

Confirm Gmail permissions are granted to the MCP server in your Google account security settings. Check that your Gmail account is not in a restricted mode. Ensure the OAuth token has not expired.

Attachment operations fail

Verify that the file paths for attachments are correct and the files are readable. Check that your Gmail account has sufficient storage for attachments. Ensure attachment size limits are respected.

Frequently Asked Questions about Gmail AutoAuth

What is Gmail AutoAuth?

Gmail AutoAuth is a Model Context Protocol (MCP) server that enables ai assistants to manage gmail through natural language interactions, supporting email operations (send, read, search, draft), comprehensive attachment handling (send, receive, download), label management, filters, and batch operations with au It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Gmail AutoAuth?

Follow the installation instructions on the Gmail AutoAuth GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Gmail AutoAuth?

Gmail AutoAuth works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Gmail AutoAuth free to use?

Yes, Gmail AutoAuth is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "gmail-autoauth-mcp-server": { "command": "npx", "args": ["-y", "gmail-autoauth-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Gmail AutoAuth?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides