Advertise
MCP.so
Sign In

Gmail MCP Server

@david-strejc

Repository

Basic information

Category

Communication

License

BSD-3-Clause license

Transports

stdio

Author

david-strejc

About Gmail MCP Server

MCP Server for interacting with Gmail via IMAP and SMTP

Gmail MCP Server config

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

{
  "mcpServers": {
    "gmail-mcp-server-david-strejc": {
      "command": "uv",
      "args": [
        "venv",
        "#",
        "Create",
        "virtual",
        "environment",
        "(.venv)"
      ]
    }
  }
}

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 Server?

The Gmail MCP Server is a Model Context Protocol (MCP) server that enables interaction with a Gmail account via IMAP and SMTP. It provides tools for email search, content retrieval, label management, batch operations, sending, and forwarding emails.

How to use Gmail MCP Server?

Clone the repository, create a Python virtual environment with uv, install dependencies, and configure environment variables in a .env file (Gmail credentials and server addresses). Run src/email_client/server.py, then add a configuration entry to your MCP client (e.g., Cline) pointing to the server script.

Key features of Gmail MCP Server

  • Search emails by date range, keyword, or raw Gmail query.
  • Retrieve full email content including headers, body, and attachments.
  • Manage Gmail labels (create, rename, delete, apply, remove).
  • Batch apply/remove labels and move multiple emails.
  • Send new emails and forward existing ones with attachments.
  • Count emails received per day within a date range.

Use cases of Gmail MCP Server

  • Automate email triage and folder organization via an AI assistant.
  • Perform bulk label operations on messages from specific queries.
  • Integrate email sending/forwarding into automated workflows.
  • Retrieve and process email content programmatically without a web browser.
  • Schedule daily email count summaries for reporting or monitoring.

Frequently asked questions

1

What are the runtime dependencies?

The server requires Python 3.x, the `uv` package manager, and IMAP/SMTP libraries installed via `uv sync`. No additional runtime is needed beyond standard Python.

2

How do I authenticate with Gmail?

Set `GMAIL_EMAIL` and `GMAIL_PASSWORD` in a `.env` file. If 2‑Factor Authentication is enabled, you must generate and use a Gmail App Password. Standard passwords will not work.

3

What transport does the server use?

The server communicates with MCP clients via standard input/output (stdio). It runs as a subprocess that reads JSON‑RPC requests from stdin and writes responses to stdout.

4

Can I use this with any MCP client?

Yes, the server is designed to work with any client that supports the Model Context Protocol, such as Cline or other compatible tools. Configuration is done per‑client in a JSON settings file.

5

Where does my email data reside?

All email data stays within your Gmail account. The server communicates directly with Gmail’s IMAP and SMTP servers; no data is cached or stored outside your account.

Comments

More Communication MCP servers

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,

SendRaven

CommonNinja

SendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.

1

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

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

SocialRobot

socialrobot-io

Schedule and analyze social media posts from Claude, ChatGPT, Cursor, or Gemini. SocialRobot's remote MCP server connects Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, and Mastodon, then creates,

Advertise