This project provides a Model Context Protocol (MCP) server for seamless Gmail integration with AI assistants like Claude Desktop. It enables users to manage their emails, including sending, reading, searching, and organizing, using natural language commands, thereby enhancing productivity and streamlining communication workflows.

How It Works

The server leverages the Gmail API and OAuth2 for secure authentication, automatically launching a browser for user consent. It supports various email formats (plain text, HTML, multipart) and handles international characters. Key features include advanced MIME structure handling for email content extraction, comprehensive label management, and efficient batch operations for bulk email processing.

Quick Start & Requirements

• Install: npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude
• Prerequisites: Google Cloud Project with Gmail API enabled, OAuth 2.0 credentials (Desktop app or Web application). For Web applications, http://localhost:3000/oauth2callback must be added to authorized redirect URIs.
• Authentication: Place gcp-oauth.keys.json in ~/.gmail-mcp/ and run npx @gongrzhe/server-gmail-autoauth-mcp auth.
• Claude Desktop Config: See README for JSON configuration.
• Docs: Full documentation

Highlighted Details

• Supports sending emails with attachments, HTML, and multipart content.
• Advanced MIME handling for robust email content extraction.
• Comprehensive label management (create, update, delete, list).
• Batch operations for efficient processing of multiple emails.
• Auto-authentication via browser launch.

Maintenance & Community

• Contributions are welcome via Pull Requests.
• Support is available by filing issues on the GitHub repository.

Licensing & Compatibility

• License: MIT
• Compatible with commercial use and closed-source linking.

Limitations & Caveats

The project relies on external Google Cloud credentials and API access. Ensure proper configuration of redirect URIs for web application credentials, especially in cloud environments. Troubleshooting common issues like "OAuth Keys Not Found" or "Port Already in Use" is detailed in the README.