Gmail MCP Server

Stablecommunication

★170 starsTypeScriptnicepkg

About

Overview

The Gmail MCP Server provides tools for AI agents to interact with Gmail. It supports reading and sending emails, managing labels, searching messages, handling attachments, and managing threads. Uses Google OAuth2 for authentication with granular scope control.

Capabilities

Tools & Capabilities

⚡send_email

Send an email from your Gmail account

⚡read_emails

Read recent emails from inbox or a label

⚡search_emails

Search emails with Gmail query syntax

⚡get_email

Get a specific email by ID with full content

⚡list_labels

List all Gmail labels

⚡add_label

Add a label to an email

Setup

Installation

bash

Install

npx -y mcp-server-gmail

Examples

Example Usage

javascript

Usage

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "mcp-server-gmail"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Quick Info

Authornicepkg

LanguageTypeScript

StatusStable

Stars★ 170

Last UpdatedFeb 12, 2026