Gmail AutoAuth MCP Server

This repository hosts a Model Context Protocol (MCP) server designed for Gmail integration with Claude Desktop, featuring automated authentication. It allows AI assistants to interact with Gmail using natural language.

Features

Key features include sending emails with attachments and international character support, reading emails with MIME handling, viewing attachment information, searching emails using various criteria, listing Gmail labels, managing emails in different folders, and deleting emails. It offers full Gmail API integration and a simple OAuth2 authentication flow supporting both Desktop and Web application credentials, with global credential storage.

Installation & Authentication

Installation can be done via Smithery or manually. Manual installation involves creating a Google Cloud Project, enabling the Gmail API, creating OAuth 2.0 credentials, and running the authentication process. The authentication process looks for gcp-oauth.keys.json and saves credentials to ~/.gmail-mcp/. Docker support is also available.

Advanced Features

It supports advanced search syntax, email content extraction from MIME structures, and international character support. Security notes, troubleshooting tips, contribution guidelines, and licensing information are also provided.