Imap MCP Server

🚀 Gmail MCP Server

A Gmail management server based on the IMAP protocol, integrating AI analysis and batch processing capabilities to help you efficiently manage your Gmail accounts.

🚀 Quick Start

This is a Gmail management server based on the IMAP protocol, integrating AI analysis and batch - processing capabilities to help you efficiently manage your Gmail accounts.

✨ Features

• AI Email Analysis: Provide insights into email usage through machine - learning algorithms.
• Smart Folder Creation: Automatically classify emails according to rules.
• Batch Operation Support: Support various operations such as moving, deleting, and marking emails.
• Email Archiving to GCS: Migrate emails and their attachments to Google Cloud Storage.

📦 Installation

1. Prepare Gmail Credentials
   • You need to have IMAP access and OAuth 2.0 support.
2. Configure Server Settings
   • Configure parameters such as Gmail account information and endpoint addresses.
3. Start the Service
   • Start the MCP server and connect to the Gmail service.

💻 Usage Examples

Core API Interfaces

• analyze_inbox(days = 7): Analyze email data from the past specified number of days and return an activity report.
• batch_process(folder, action, criteria): Perform batch operations on emails in the specified folder.
• migrate_email_to_gcs(uid, folder, gcs_prefix): Migrate the specified email to Google Cloud Storage.

Basic Usage

# Analyze inbox data for the last week
inbox_analysis = analyze_inbox(days=7)

# Batch - label important emails
batch_process(folder='INBOX', action='label', criteria='unread AND importance:high')

# Migrate an important email to GCS
migrate_email_to_gcs(uid='123456', folder='INBOX', gcs_prefix='important-mails')

📚 Documentation

Functional Modules

Email Analysis

• analyze_inbox(days = 7): Analyze email data from the past specified number of days and return an activity report.
• get_folder_summary(folder): Get statistical information about the specified folder, including the number of emails and activity trends.

Batch Operations

• batch_process(folder, action, filter_criteria): Perform batch operations on emails in the specified folder, supporting actions such as moving, deleting, and marking.

Smart Classification

• create_smart_folder(name, rules): Create a custom smart folder to automatically classify emails according to specified rules.

Email Migration

• migrate_email_to_gcs(uid, folder, gcs_prefix): Migrate the specified email and its attachments to Google Cloud Storage.

🔧 Technical Details

Dependencies

• Python Version: 3.8+
• IMAP Library: imaplib
• GCS Interface: google - cloud - storage

Authentication Requirements

• OAuth 2.0 Support
• IMAP Global Read Permission

📋 Use Cases

• Enterprise Email Management: Unified management and analysis of a large number of employee email accounts.
• Data Migration: Migrate historical emails and attachments to cloud storage.
• Automated Processing: Automatically classify and clean emails through batch operations.

📄 License

⚠️ Important Note

Please comply with Gmail's API usage guidelines and rate limits.

⚠️ Important Note

Ensure that you have legal authorization.

⚠️ Important Note

Regularly update your credential information.

For more detailed information, please refer to the complete developer documentation.