iflow-mcp_tonykipkemboi_gmail-imap-mcp

# Gmail IMAP MCP Server A Model Context Protocol (MCP) server for Gmail integration using IMAP. This server allows AI assistants to interact with Gmail accounts, providing functionality to read, search, and manage emails. ## Features - OAuth2 authentication with Gmail - Read emails from Gmail accounts - Search emails with advanced query options - View unread emails - Send emails with attachments - Manage labels (create, delete, list) - Move emails between labels - Download attachments - Mark emails as read/unread - Support for multiple Gmail accounts - Integration with AI assistants through MCP ## Prerequisites Before running the Gmail IMAP MCP server, ensure you have the following: 1. Python 3.12 or higher 2. Google Cloud Project with Gmail API enabled 3. OAuth 2.0 Client ID credentials ## Installation ### Install from source 1. Clone the repository: ``` git clone https://github.com/yourusername/gmail-imap-mcp.git cd gmail-imap-mcp ``` 2. Create and activate a virtual environment: ``` python -m venv .venv # On Windows .venv\Scripts\activate # On Unix/MacOS source .venv/bin/activate ``` 3. Install the package: ``` pip install -e . ``` ## Setup Google Cloud Project 1. Go to the [Google Cloud Console](https://console.cloud.google.com/) 2. Create a new project or select an existing one 3. Enable the Gmail API for your project: - Navigate to "APIs & Services" > "Library" - Search for "Gmail API" and enable it 4. Create OAuth 2.0 credentials: - Go to "APIs & Services" > "Credentials" - Click "Create Credentials" > "OAuth client ID" - Choose "Desktop app" as application type - Download the client configuration file 5. Save the downloaded file as `client_secret.json` in the credentials directory: ``` mkdir -p ~/.gmail_imap_mcp_credentials # Move the downloaded file to ~/.gmail_imap_mcp_credentials/client_secret.json ``` ## Architecture and Implementation Details ### Credential Storage …