Gmail IMAP MCP Server

Name: Gmail IMAP MCP Server
Author: tonykipkemboi

@tonykipkemboi

代码仓库

关于 Gmail IMAP MCP Server

Gmail IMAP MCP server for integrating Gmail with Claude and other AI assistants

#gmail #imap #mcp #ai-assistant #email-integration

基本信息

分类

沟通协作

运行时

python

传输方式

stdio

发布者

tonykipkemboi

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "gmail-imap-mcp": {
      "command": "python",
      "args": [
        "-m",
        "gmail_imap_mcp.server"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Gmail IMAP MCP Server?

A Model Context Protocol (MCP) server for Gmail integration using IMAP. It enables AI assistants to read, search, and manage Gmail accounts through OAuth2 authentication and a set of IMAP-based tools.

How to use Gmail IMAP MCP Server?

Install from source with Python 3.12+, enable the Gmail API in a Google Cloud project, create OAuth2 credentials, and run the command gmail-imap-mcp. Use the authenticate-gmail tool to authenticate an account, then invoke tools like search-emails, send-email, or create-label.

Key features of Gmail IMAP MCP Server

OAuth2 authentication with Gmail
Read, search, and send emails with attachments
Manage labels (create, delete, list)
Move emails between labels
Download attachments from emails
Mark emails as read/unread
Support for multiple Gmail accounts simultaneously

Use cases of Gmail IMAP MCP Server

An AI assistant reads and summarizes recent inbox emails for a user.
A user instructs an AI to search for emails from a specific sender and reply.
An AI helps organize emails by creating labels and moving messages between them.
A developer integrates Gmail management into a custom MCP-enabled AI workflow.

FAQ from Gmail IMAP MCP Server

How do I authenticate a Gmail account?

Use the authenticate-gmail tool with your email address. An OAuth2 flow will open in your browser; after granting permission, the server stores the token for future sessions.

What are the prerequisites?

Python 3.12 or higher, a Google Cloud Project with the Gmail API enabled, and OAuth 2.0 Client ID credentials (download as client_secret.json).

How do I start the server and connect it to Claude Desktop?

Run python -m gmail_imap_mcp.server to start the server. Then in Claude Desktop, navigate to Settings and configure the MCP server endpoint.

Where are credentials stored?

OAuth credentials and tokens are stored in ~/.gmail_imap_mcp_credentials/ — separate token files per account (format token_{email}.json). This location is user‑specific and persists across sessions.

What is the email ID format?

Email IDs follow the pattern email://message/{account}_{mailbox}_{id}, where account is the Gmail address, mailbox is the label, and id is the IMAP unique ID.

沟通协作分类下的更多 MCP 服务器

Email sending MCP 💌

resend

The official MCP server to send emails and interact with Resend

549

Mattermost MCP Server

pvev

Mattermost MCP server to enable Claude to interact with Mattermost Workspaces

PhonePi MCP: Turn your phone into a toolbox for AI assistants using Model Context Protocol

priyankark

PhonePi MCP enables seamless integration between desktop AI tools and your smartphone, providing 23+ direct actions including SMS messaging, phone calls, contact management, snippet creation and search, clipboard sharing, notifications, battery status checks, and remote device co