Gmail logo

Gmail

Free

支持自动认证的 Gmail 集成,用于 Claude Desktop。

FreeFree tier
Type
Open Source

About Gmail

Gmail AutoAuth MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop to manage Gmail through natural language interactions. It provides comprehensive email management capabilities including sending emails with attachments, reading emails with full MIME structure support, searching by various criteria, managing labels, and performing batch operations. The server features a simple OAuth2 authentication flow with automatic browser launch, supports both Desktop and Web application credentials, and offers global credential storage for convenience. It is open source and free to use, with installation available via Smithery or manual setup.

Key Features

Send emails with subject, content, attachments, and recipients
Full attachment support - send and receive file attachments
Download email attachments to local filesystem
Support for HTML emails and multipart messages with both HTML and plain text versions
Full support for international characters in subject lines and email content
Read email messages by ID with advanced MIME structure handling
Search emails with various criteria (subject, sender, date range)
Comprehensive label management with ability to create, update, delete and list labels
List emails in inbox, sent, or custom labels
Mark emails as read/unread and move emails to different labels/folders

Pros & Cons

Pros
  • Free and open source with full access to code
  • Comprehensive Gmail API integration covering send, read, search, labels, and batch operations
  • Simple authentication with auto browser launch and global credential storage
  • Supports advanced email features like HTML, multipart messages, and international characters
  • Can be installed easily via Smithery or npm
Cons
  • Repository is archived and read-only (no longer actively maintained)
  • Requires manual setup of a Google Cloud Project and OAuth 2.0 credentials
  • Dependent on Gmail API, which may have usage quotas
  • Only works with Claude Desktop or other MCP-compatible clients

Best For

Manage Gmail inbox through natural language conversations with Claude DesktopAutomate email sending, searching, and labeling tasks via AI assistantIntegrate Gmail functionality into custom AI workflows using MCP protocolProcess email attachments and download them to local filesystem automatically

FAQ

How do I install the Gmail MCP Server?
You can install it automatically via Smithery using 'npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude', or manually by creating a Google Cloud Project, enabling the Gmail API, generating OAuth credentials, and running the authentication command.
How do I authenticate with Gmail?
Authentication is done via OAuth2 with auto browser launch. You need a gcp-oauth.keys.json file placed in ~/.gmail-mcp/ (global) or the current directory. Run 'npx @gongrzhe/server-gmail-autoauth-mcp auth' to start the flow.