What is the Gmail IMAP MCP Server?

The Gmail IMAP MCP Server is a component available in the UBOS Asset Marketplace that allows AI assistants to interact with Gmail accounts using the Model Context Protocol (MCP). It enables AI to read, search, manage, and send emails.

What are the prerequisites for using the Gmail IMAP MCP Server?

You need Python 3.12 or higher, a Google Cloud Project with the Gmail API enabled, and OAuth 2.0 Client ID credentials.

How do I install the Gmail IMAP MCP Server?

Clone the repository, create a virtual environment, and install the package using pip install -e .

How do I set up a Google Cloud Project for the Gmail IMAP MCP Server?

Create or select a Google Cloud Project, enable the Gmail API, and create OAuth 2.0 credentials. Download the client configuration file and save it as client_secret.json in the credentials directory.

How do I authenticate a Gmail account with the MCP Server?

Use the authenticate-gmail tool with your email address and follow the OAuth2 authentication flow in your browser.

What are some common use cases for the Gmail IMAP MCP Server?

Automated customer support, intelligent email filtering and organization, meeting scheduling and reminders, lead generation and qualification, personalized email marketing.

What are the key features of the Gmail IMAP MCP Server?

OAuth2 authentication, comprehensive email retrieval, email sending with attachments, label management, multiple account support, and integration with AI assistants through MCP.

How do I integrate the Gmail IMAP MCP Server with Claude Desktop?

Add the Gmail IMAP MCP server configuration to Claude Desktop’s MCP settings, including the server URL and the list of available tools.

What is the recommended workflow for handling emails with Claude Desktop and the Gmail IMAP MCP Server?

Search for unread emails, retrieve the full content of each email, determine if it’s a new conversation or a continuation of an existing thread, use the appropriate reply function, and mark the email as read.

How does the Gmail IMAP MCP Server handle contact form emails?

It automatically detects contact form emails, extracts the true sender from Reply-To headers, identifies the website source, extracts the message content, and displays it in a clear, structured format.

What is the email ID format used by the Gmail IMAP MCP Server?

The email ID format is email://message/{account}_{mailbox}_{id}.

Where are OAuth2 credentials stored?

OAuth2 credentials are stored locally in the ~/.gmail_imap_mcp_credentials directory.

What should I do if I have authentication issues?

Ensure your client_secret.json is correctly placed, check that you’ve enabled the Gmail API in your Google Cloud Project, and try re-authenticating if your token has expired.

How do I handle situations when Claude Desktop uses backticks in JSON?

The server converts backtick-formatted JSON (name) to proper JSON ("name"), providing error handling and seamless integration.