MCP.so
Sign In

Gmail MCP Server

@cristip73

Repository

About Gmail MCP Server

No overview available yet

Config

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

{
  "mcpServers": {
    "MCP-email-server": {
      "command": "npx",
      "args": [
        "@cristip73/email-mcp"
      ]
    }
  }
}

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

The Gmail MCP Server is a Model Context Protocol (MCP) server that lets Claude Desktop (or any MCP‑compatible app) read, search, send, and manage Gmail emails through a standardised interface. It is designed for users who want to automate email tasks using AI, with behaviour that mirrors Gmail’s own workflows.

How to use Gmail MCP Server?

Install via npx @cristip73/email-mcp (recommended) or clone and build the source. First‑time setup requires Google Cloud OAuth credentials placed in ~/.email-mcp/gcp-oauth.keys.json, then run npx @cristip73/email-mcp auth to authenticate. Configure the server in claude_desktop_config.json with environment variables TIME_ZONE (e.g., GMT+2) and DEFAULT_ATTACHMENTS_FOLDER (a valid path on your system). After saving the config, restart Claude Desktop.

Key features of Gmail MCP Server

  • Send, reply, reply‑all, forward, and CC/BCC emails.
  • Search emails with advanced filters and Gmail category support.
  • Create, update, list, and delete drafts.
  • Manage custom labels and label visibility/colors.
  • Mark messages as read/unread, archive, or trash.
  • List and save attachments securely to a designated folder.
  • Adjust email dates to the user’s configured time zone.
  • Multi‑account support and proper UTF‑8 encoding.

Use cases of Gmail MCP Server

  • Let Claude draft and send emails with CC/BCC and attachments.
  • Search inbox for yesterday’s messages in the “Primary” category.
  • Save incoming attachments to a predefined local folder.
  • Manage draft messages: create, edit, and send later.
  • Organise emails by creating and applying custom labels.

FAQ from Gmail MCP Server

What makes this server different from other MCP email servers?

Besides standard send/read/search, it supports reply‑all, CC/BCC, quoting the original message, forwarding, draft management, label management, marking as read/unread/archived, attachment saving, and category management (Primary, Social, Promotions, etc.). It also adjusts dates to the user’s time zone.

Do I need Google Cloud OAuth credentials?

Yes. You must create a Google Cloud project, enable the Gmail API, and generate an OAuth 2.0 client ID for a desktop application. Save the downloaded JSON as gcp-oauth.keys.json in your current working directory or in ~/.email-mcp/.

How do I set the time zone and attachments folder?

Set the environment variables TIME_ZONE (e.g., GMT+2) and DEFAULT_ATTACHMENTS_FOLDER (e.g., /Users/username/CLAUDE/Attachments) in the claude_desktop_config.json entry for the server. If not set, the time zone defaults to GMT+0 and attachment saving will not work.

Can Gmail MCP Server schedule emails?

No. Gmail does not support scheduled email sending, so the server cannot schedule messages for later delivery.

What is the best practice for sending important emails via Claude?

Ask Claude to write the email/reply/forward and save it as a draft. You can then review the draft and send it manually. This is recommended for important messages.

Frequently asked questions

What makes this server different from other MCP email servers?

Besides standard send/read/search, it supports reply‑all, CC/BCC, quoting the original message, forwarding, draft management, label management, marking as read/unread/archived, attachment saving, and category management (Primary, Social, Promotions, etc.). It also adjusts dates to the user’s time zone.

Do I need Google Cloud OAuth credentials?

Yes. You must create a Google Cloud project, enable the Gmail API, and generate an OAuth 2.0 client ID for a desktop application. Save the downloaded JSON as `gcp-oauth.keys.json` in your current working directory or in `~/.email-mcp/`.

How do I set the time zone and attachments folder?

Set the environment variables `TIME_ZONE` (e.g., `GMT+2`) and `DEFAULT_ATTACHMENTS_FOLDER` (e.g., `/Users/username/CLAUDE/Attachments`) in the `claude_desktop_config.json` entry for the server. If not set, the time zone defaults to GMT+0 and attachment saving will not work.

Can Gmail MCP Server schedule emails?

No. Gmail does not support scheduled email sending, so the server cannot schedule messages for later delivery.

What is the best practice for sending important emails via Claude?

Ask Claude to write the email/reply/forward and save it as a draft. You can then review the draft and send it manually. This is recommended for important messages.

Comments

Basic information

Category

Communication

Transports

stdio

Author

cristip73

More Communication MCP servers

Mcp Telegram

dryeab

MCP Server for Telegram

244

MCP Communicator (Telegram)

qpd-v

An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.

45

MCP Teams Server

InditexTech

An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.

383

mcp-email-server

ai-zerolab

IMAP and SMTP via MCP Server

270

Slack MCP Server

korotovsky

The most powerful MCP Slack Server with no permission requirements, Apps support, GovSlack, DMs, Group DMs and smart history fetch logic.

1.7K