Gmail M C P Server

安装配置

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

README 摘要

# Gmail AutoAuth MCP Server 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.  [](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp) ## 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 - **Enhanced attachment display** showing filenames, types, sizes, and download IDs - Search emails with various criteria (subject, sender, date range) - **Comprehensive label management with ability to create, update, delete and list labels** - List all available Gmail labels (system and user-defined) - List emails in inbox, sent, or custom labels - Mark emails as read/unread - Move emails to different labels/folders - Delete emails - **Batch operations for efficiently processing multiple emails at once** - Full integration with Gmail API - Simple OAuth2 authentication flow with auto browser launch - Support for both Desktop and Web application credentials - Global credential storage for convenience ## Installation & Authentication ### Installing via Smithery To install Gmail AutoAuth for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp): ```bash npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude ``` ### Installing Manually 1. Create a Google Cloud Project and obtain credentials: a. Create a Google Cloud Project: - Go to [Google Cloud Console](https://console.cloud.google.com/) - Create a new project or select an existing one - Enable the Gmail API for your project b. Create OAuth 2.0 Credentials: - Go to "APIs & Services" > "Credentials" - Click "Create Credentials" > "OAuth client ID" - Choose either "Desktop app" or "Web application" as application type - Give it a name and click "Create" - For Web application, add `http://localhost:3000/oauth2callback` to the authorized redirect URIs - Download the JSON file of your client's OAuth keys - Rename the key file to `gcp-oauth.keys.json` 2. Run Authentication: You can authenticate in two ways: a. Global Authentication (Recommended): ```bash # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder mkdir -p ~/.gmail-mcp mv gcp-oauth.keys.json ~/.gmail-mcp/ # Run authentication from anywhere npx @gongrzhe/server-gmail-autoauth-mcp auth ``` b. Local Authentication: ```bash # Place gcp-oauth.keys.json in your current directory # The file will be automatically copied to global config npx @gongrzhe/server-gmail-autoauth-mcp auth ``` The authentication process will: - Look for `gcp-oauth.keys.json` in the current directory or `~/.gmail-mcp/` - If found in current directory, copy it to `~/.gmail-mcp/` - Open your default browser for Google authentication - Save credentials as `~/.gmail-mcp/credenti...