MCP.so
Sign In

Gmail MCP

@ykuchiki

Repository

About Gmail MCP

MCP server for Gmail API implemented in Python. Enables AI Agents to send, receive, search emails and manage labels in Gmail.

Basic information

Category

Communication

License

MIT license

Runtime

python

Transports

stdio

Publisher

ykuchiki

Config

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

{
  "mcpServers": {
    "gmail-mcp-ykuchiki": {
      "command": "uv",
      "args": [
        "init"
      ]
    }
  }
}

Tools

No tools detected

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

Overview

What is Gmail MCP?

Gmail MCP is a server implementation that enables AI assistants to interact with Gmail through the Model Context Protocol (MCP). It provides tools for sending emails, managing drafts, reading emails, searching through your inbox, and managing Gmail labels. It uses OAuth2.0 authentication with the Gmail API.

How to use Gmail MCP?

Set up a Google Cloud Platform project with the Gmail API enabled, download OAuth credentials as credentials/client_secret_gmail_oauth.json, and install Python dependencies using uv. Then configure your MCP client to point to the server with uv run main.py. On first run, you will be prompted to authenticate with your Gmail account.

Key features of Gmail MCP

  • Send emails and create drafts
  • Read and search emails
  • Delete emails
  • Manage Gmail labels (create, update, delete)
  • OAuth2.0 authentication with Gmail API

Use cases of Gmail MCP

  • AI assistant composing and sending emails on behalf of a user
  • Searching and summarizing recent emails from the inbox
  • Managing labels to categorize threads automatically
  • Deleting unwanted emails programmatically

FAQ from Gmail MCP

What are the prerequisites?

Python 3.11 or higher, a Gmail account, a Google Cloud Platform project with the Gmail API enabled, and the uv package installer.

How do I set up OAuth credentials?

Create a project in Google Cloud Console, enable the Gmail API, create OAuth credentials, download the JSON file, and save it as credentials/client_secret_gmail_oauth.json in the project root.

What MCP clients are supported?

The server works with any MCP‑compatible client. Specific client integration instructions should be sought from the client’s official documentation.

How does authentication work?

The server uses OAuth 2.0. On first run, it prompts the user to authenticate with their Gmail account.

What runtime dependencies are required?

All dependencies are listed in requirements.txt and installed via uv pip install -r requirements.txt. The server is invoked using uv run main.py.

Comments

More Communication MCP servers

MCP-Discord

barryyip0625

Implement Discord MCP server enabling AI assistants to interact with the Discord platform.

94

Mattermost MCP Server

pvev

Mattermost MCP server to enable Claude to interact with Mattermost Workspaces

39

MCP Email Server

Shy2593666979

一个基于 MCP (Model Context Protocol) 的邮件服务，支持 LLM 发送带附件的电子邮件及在指定目录中搜索文件。提供安全的 SMTP 传输、多收件人支持和附件模式匹配搜索功能，适用于 Gmail、Outlook、Yahoo、QQ 邮箱和网易 126 邮箱等主流邮箱服务。

78

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

35

Telegram MCP Server

chigwell

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.

1.3K