Advertise
MCP.so
Sign In

Gmail IMAP MCP Server

@tonykipkemboi

Repository

Basic information

Category

Communication

Transports

stdio

Author

tonykipkemboi

About Gmail IMAP MCP Server

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

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

Gmail IMAP MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Gmail IMAP MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

1

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.

2

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`).

3

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.

4

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.

5

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.

Comments

More Communication MCP servers

HelpWell

Workado, LLC

HelpWell connects AI assistants to your help desk, knowledge base, live chat support and email marketing automation for SaaS. Triage support tickets, draft help docs and replies, manage contacts, and prepare newsletters

ARVX

Centric AI, Inc.

Email for long-term client relationships: ARVX reads each person first and remembers every pair.

Socialync

Jack Vitick

Draft, schedule, and publish social media posts to 8 platforms from any AI agent: Facebook, Instagram, X, TikTok, YouTube, LinkedIn, Threads, and Bluesky. 19 tools covering drafting, scheduling, publishing, media upload,

DemandBird

DemandBird

Write, schedule and publish social posts in your own voice, and read your analytics, from Claude, ChatGPT or any MCP client. Works with LinkedIn, X, Threads, Bluesky, Facebook, Instagram and more. Hosted, with OAuth sign

DashaMail

DashaMail

MCP server for DashaMail email marketing service

Advertise