Gmail MCP Server

@ykuchiki

Basic information

About Gmail MCP Server

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

Gmail MCP Server config

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

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

Gmail 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 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

Frequently asked questions

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

RelayLink

RelayLink lets your AI assistant send briefings to other people's AI assistants. Draft a package from your current conversation, attach files, approve the note, and the recipient's AI gets the full context: decisions, op

call4me

Nick Khami

call4me lets your AI agent make real phone calls for you. Ask Claude, ChatGPT, Cursor, Codex or your own app to book a table, schedule a dentist appointment, cancel a subscription or ask a business a question. It calls,

2pr.io

Write, schedule and publish LinkedIn posts in your own voice, reply to comments and read your analytics, all from your AI assistant. Remote MCP server with OAuth sign-in.

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,

SomaCheck Vibecheck

Sensie-agents

Body language for AI agents, on your terms. A consented three-second phone gesture gives your agent an Aligned or Unaligned signal with confidence. You remain the authority.