Gmail MCP

What it does

Gmail MCP provides a secure bridge between AI assistants and the Gmail API. It implements a full OAuth 2.1 authorization server, allowing tools like Claude Code to authenticate and interact with your emails directly. It supports dynamic client registration and PKCE for secure authentication.

Tools

• list_emails: Retrieve a list of emails from the inbox with optional filters.
• read_email: Fetch the full content of a specific email by its ID.
• search_emails: Perform powerful searches using standard Gmail query syntax.
• send_email: Compose and send new emails.
• reply_to_email: Send replies to existing conversations.
• draft_email: Create email drafts for later review.
• archive_email: Move emails out of the inbox to archives.
• trash_email: Move unwanted emails to the trash.
• add_label/remove_label: Organize emails using Gmail labels.
• get_thread: Retrieve all messages within a specific conversation thread.

Installation

Clone, build and start the server:

git clone https://github.com/jsflax/gmail-mcp && cd gmail-mcp && npm install && npm run build && npm start

Configure in ~/.mcp.json:

{
  "mcpServers": {
    "gmail": {
      "type": "sse",
      "url": "http://localhost:3100/sse"
    }
  }
}

Supported hosts

Confirmed for Claude Code (SSE transport).