Gmail MCP Server

@highlight-ing

About Gmail MCP Server

No overview available yet

Config

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

{
  "mcpServers": {
    "gmail-mcp-server-highlight-ing": {
      "command": "node",
      "args": [
        "get-refresh-token.js"
      ]
    }
  }
}

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?

Gmail MCP Server is a Model Context Protocol (MCP) server that provides tools for interacting with the Gmail API. It enables developers to manage emails programmatically—listing, searching, sending, and modifying messages—through the MCP interface.

How to use Gmail MCP Server?

Ensure Node.js 14+ is installed. Set up a Google Cloud project, enable the Gmail API, and create OAuth 2.0 credentials (Web application) with redirect URI http://localhost:3001/code. Place a credentials.json file in the root directory, then run node get-refresh-token.js to authorize the required scopes (gmail.modify, gmail.send) and obtain a refresh token. Configure your MCP settings file (e.g., cline_mcp_settings.json or claude_desktop_config.json) with the server command pointing to the built index.js and the access token in environment variables. Finally, run npm run build and start the MCP client.

Key features of Gmail MCP Server

List recent emails with optional filtering
Advanced email search using Gmail query syntax
Send new emails with CC and BCC support
Modify email labels (archive, trash, mark read/unread)

Use cases of Gmail MCP Server

Automate inbox triage and label management
Send programmatic replies or notifications via email
Search for specific emails by sender, subject, or attachment
Integrate email actions into AI-powered workflows

FAQ from Gmail MCP Server

What dependencies are required to run Gmail MCP Server?

Node.js version 14 or higher, a Google Cloud project with the Gmail API enabled, and OAuth 2.0 credentials (Client ID and Client Secret) are required.

How does authentication work?

The server uses OAuth 2.0 with a refresh token. Run node get-refresh-token.js to open a browser for consent, then the token is saved to token.json and the refresh token is displayed.

What Gmail API permissions does the server request?

It requests two scopes: https://www.googleapis.com/auth/gmail.modify and https://www.googleapis.com/auth/gmail.send.

How do I configure the server in an MCP client?

Add an entry to the mcpServers object in your MCP settings file with command node, args pointing to the built build/index.js, and an environment variable GOOGLE_ACCESS_TOKEN set to the obtained access token.

What email operations can I perform with this server?

You can list emails, search emails using Gmail query syntax, send emails with optional CC/BCC, and modify email labels (e.g., archive, trash, mark as read/unread).

Frequently asked questions

What dependencies are required to run Gmail MCP Server?

Node.js version 14 or higher, a Google Cloud project with the Gmail API enabled, and OAuth 2.0 credentials (Client ID and Client Secret) are required.

How does authentication work?

The server uses OAuth 2.0 with a refresh token. Run `node get-refresh-token.js` to open a browser for consent, then the token is saved to `token.json` and the refresh token is displayed.

What Gmail API permissions does the server request?

It requests two scopes: `https://www.googleapis.com/auth/gmail.modify` and `https://www.googleapis.com/auth/gmail.send`.

How do I configure the server in an MCP client?

Add an entry to the `mcpServers` object in your MCP settings file with command `node`, args pointing to the built `build/index.js`, and an environment variable `GOOGLE_ACCESS_TOKEN` set to the obtained access token.

What email operations can I perform with this server?

You can list emails, search emails using Gmail query syntax, send emails with optional CC/BCC, and modify email labels (e.g., archive, trash, mark as read/unread).

Comments

Basic information

More Communication MCP servers

Telegram MCP Server

kfastov

Telegram user console client and archiver

MCP Headless Gmail Server

baryhuang

A MCP (Model Context Protocol) server that provides get, send Gmails without local credential or token setup.

MCP Email Server

Shy2593666979

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

飞书MCP服务器

sdd330

MCP server provides feishu related operations

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