Gmail MCP Server

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

Communication tools Developer tools #Email Management #Automatic Authentication #Batch Operations #Label System .TypeScript

rating : 4.5 points

downloads : 277

update time : 2025-04-29

What is the Gmail AutoAuth MCP Server?

The Gmail AutoAuth MCP Server is a powerful tool that allows users to manage and operate Gmail by interacting with an AI assistant in natural language. You can easily send, receive, and organize emails, while also supporting batch operations and international character support.

How to use the Gmail AutoAuth MCP Server?

You can complete the setup and start using it in just a few steps. First, install the server and authenticate, then execute various email management tasks through simple commands or prompts.

Applicable Scenarios

Suitable for individual users or teams who need efficient email management, especially those who want to automate the email processing workflow.

Main Features

Send EmailYou can send a new email with a subject, body, attachments, and recipients.

Draft EmailCreate an unsent draft email.

Read EmailGet the full content of a specific email based on the email ID.

Search EmailsUse Gmail's advanced search syntax to find emails.

Modify Email LabelsAdd or remove labels from an email (e.g., archive, move to another folder).

Delete EmailPermanently delete the specified email.

List All LabelsView all system and custom labels.

Create LabelCreate a new Gmail label.

Batch Modify EmailsPerform efficient batch operations on multiple emails.

Advantages and Limitations

Advantages

Supports automatic authentication, simplifying the login process.

Fully supports international characters, ensuring no garbled characters in email content.

Provides a rich set of batch operation functions, improving efficiency.

Deeply integrated with the Gmail API, with powerful and stable functions.

Limitations

Requires an internet connection to work properly.

Requires configuring a Google Cloud project and OAuth credentials when using it for the first time.

Does not support operations in offline mode.

How to Use

Install the Server

Install the Gmail AutoAuth MCP Server via npm or Docker.

Configure the Client

Configure the MCP server address in Claude Desktop.

Execute Commands

Use the provided commands or prompts to perform specific tasks.

Usage Examples

Send an EmailSend an email with an attachment to the specified recipient.

Batch Delete EmailsDelete multiple emails marked as spam.

Frequently Asked Questions

How to solve the problem of OAuth authentication failure?

Why can't some emails be read correctly?

How to limit the number of operations per batch?

Related Resources

Official Documentation

The GitHub homepage of the Gmail AutoAuth MCP Server.

Installation Guide

Detailed installation and configuration guide.

Video Tutorial

Quick-start video tutorial.

🚀 Gmail Automated Control Panel Server-side README

Gmail Automated Control Panel (MCP) is a powerful tool designed to fully automate the management of Gmail accounts via the command line. It supports OAuth 2.0 authentication and offers a rich set of APIs for batch email operations.

🚀 Quick Start

Gmail MCP provides a convenient way to manage Gmail accounts. Follow the steps below to get started.

📦 Installation

1. Install Dependencies

pip install google.oauth2 googleapiclient gmail-mcp

2. Initialize Configuration

Create a blank YAML configuration file:

mkdir -p ~/.gmail-mcp && touch ~/.gmail-mcp/config.yaml

3. Authentication Process

Run the following command to start the OAuth authentication process:

python -m gmail_mcp.auth

Complete Google's OAuth consent process as prompted.

✨ Features

Tool List

The following are the main tools provided by Gmail MCP and their function descriptions:

Tool Name	Function Description
`gmail.search`	Search for emails based on a specified query
`gmail.fetch`	Retrieve emails according to conditions
`gmail.label`	Manage email labels (create, modify, delete)
`gmail.batch`	Perform batch operations (send, delete, etc.)
`gmail.attachment`	Download or manage attachments
`gmail.header`	Manipulate email header information
`gmail.body`	Get or set email body content
`gmail.star`	Mark/unmark emails as starred
`gmail.spam`	Move emails to the spam folder or restore them
`gmail.draft`	Manage draft emails
`gmail.sent`	Manipulate sent emails
`gmail.trash`	Move emails to the trash or delete them

Advanced Search Syntax

Gmail MCP supports the following advanced search operators:

Operator	Example	Description
`from:`	`from:john@example.com`	Search for emails from a specific sender
`to:`	`to:mary@example.com`	Search for emails sent to a specific recipient
`subject:`	`subject:"meeting notes"`	Search for emails with a subject containing specified text
`has:attachment`	`has:attachment`	Search for emails with attachments
`after:`	`after:2024/01/01`	Search for emails received after a specified date
`before:`	`before:2024/02/01`	Search for emails received before a specified date
`is:`	`is:unread`	Search for unread emails
`label:`	`label:work`	Search for emails with a specific label

Label Management

Gmail MCP provides comprehensive label management functions, including:

Create custom labels
Update existing label information
Delete user-created labels
Get a list of all system and custom labels

🔧 Technical Details

Security Precautions

OAuth Authentication: Authenticate via OAuth 2.0 with two-step verification enabled by default.
Data Encryption: All API requests are transmitted through an SSL encrypted channel.
Access Control: Support role-based access control (RBAC), allowing only authorized users to operate by default.

Troubleshooting

Common issues and solutions:

Unable to connect to the Gmail server: Check your network connection or try changing your DNS service provider.
Authentication failure: Ensure that the OAuth token is valid and not expired.
Empty search results: Verify that the search criteria are correct, or check if the emails have specific labels.

🤝 Contribution Guidelines

Contributions are welcome! Please refer to the CONTRIBUTING.md file in the project repository to learn how to participate in development.

📄 License

This project is licensed under the MIT License. Please see the LICENSE file for details.

This tool aims to help developers and system administrators efficiently manage Gmail accounts and support automated email processing workflows through scripts.

send_email

Send an email.

Parameters

--from : string*

Description

The email address of the sender.

Parameters

--to : string*

Description

The email address of the recipient.

Parameters

--subject : string*

Description

The subject of the email.

Parameters

--body : string*

Description

The content of the email body.

get_inbox

Get the inbox list.

Parameters

--page : integer*

Description

The page number to retrieve.

create_folder

Create a new folder.

Parameters

--name : string*

Description

The name of the folder.

delete_message

Delete the message with the specified ID.

Parameters

--message_id : string*

Description

The unique identifier of the message to be deleted.

search_messages

Search for messages that meet the criteria.

Parameters

--query : string*

Description

The query criteria used to filter messages.

update_contact

Update contact information.

Parameters

--contact_id : string*

Description

The unique identifier of the contact to be updated.

Parameters

--email : string*

Description

The new email address (optional).

Parameters

--phone : string*

Description

The new phone number (optional).

get_contacts

Get a list of all contacts or contacts on a specific page.

Parameters

--page : integer*

Description

The page number to retrieve (optional, default is the first page).

create_contact

Create a new contact.

Parameters

--name : string*

Description

The name of the contact.

Parameters

--email : string*

Description

The email address of the contact.

Parameters

--phone : string*

Description

The phone number of the contact (optional, default is empty).

Parameters

--notes : string*

Description

Remarks (optional, default is empty).

batch_send_emails

Send emails in batches.

Parameters

--from : string*

Description

The email address of the sender.

Parameters

--to : string*

Description

The file path or string containing multiple recipient email addresses.

Parameters

--body : string*

Description

The template for the email body, supporting variable substitution.

monitor_usage

Monitor system resource usage.

Parameters

--interval : integer*

Description

The monitoring time interval (in seconds).

Parameters

--output_file : string*

Description

The file path to save the monitoring results (optional, default is to output to the console).

Featured MCP Services

Notion Api MCP

Certified

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

1.7K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

554

5 points

Figma Context MCP

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご