gogcli-mcp-gmail

name	gogcli-mcp-gmail
description	Use when the user asks to read, organize, draft, forward, autoreply, or otherwise work with Gmail in depth. Triggers for requests involving threads, labels, drafts, attachments, bulk archive/trash/mark-read operations, forwarding messages, or any Gmail operation beyond simple search/get/send. Includes auth and Gmail tools only.

gogcli-mcp-gmail

Extended Gmail MCP server via gogcli — 32 tools: auth + 4 base Gmail + 23 extra dedicated Gmail tools.

• Source: github.com/chrischall/gogcli-mcp

Requirements

• gogcli installed and authenticated
• Node.js 18 or later

Setup

{
  "mcpServers": {
    "gogcli-gmail": {
      "command": "npx",
      "args": ["-y", "gogcli-mcp-gmail"],
      "env": {
        "GOG_ACCOUNT": "[e-mail]"
      }
    }
  }
}

Extra Gmail Tools

Read

Tool	What it does
gog_gmail_raw	Raw Gmail API JSON for a message
gog_gmail_attachment	Download an attachment and deliver its contents — inline when ≤3 MiB, else uploaded to Drive with a link (deliver: auto/inline/drive/off)
gog_gmail_url	Print web URLs for threads
gog_gmail_history	List history events since a historyId

Threads

Tool	What it does
gog_gmail_thread_get	Get a thread with all messages
gog_gmail_thread_modify	Modify labels on a thread
gog_gmail_thread_attachments	List/download all attachments in a thread

Labels

Tool	What it does
gog_gmail_labels_list	List all labels
gog_gmail_labels_get	Get a label's details and counts
gog_gmail_labels_create	Create a new label
gog_gmail_labels_rename	Rename a label
gog_gmail_labels_delete	Delete a label
gog_gmail_labels_modify	Modify labels on one or more threads

Bulk operations

Tool	What it does
gog_gmail_archive	Archive by IDs or query
gog_gmail_mark_read	Mark read by IDs or query
gog_gmail_mark_unread	Mark unread by IDs or query
gog_gmail_trash	Trash by IDs or query
gog_gmail_message_modify	Modify labels on a single message
gog_gmail_batch_delete	Permanently delete multiple messages
gog_gmail_batch_modify	Modify labels on multiple messages

Drafts

Tool	What it does
gog_gmail_drafts_list	List drafts
gog_gmail_drafts_get	Get a draft
gog_gmail_drafts_create	Create a draft
gog_gmail_drafts_update	Update a draft
gog_gmail_drafts_delete	Delete a draft
gog_gmail_drafts_send	Send a draft

Write

Tool	What it does
gog_gmail_forward	Forward a message
gog_gmail_autoreply	Reply once to all messages matching a query

Plus 5 auth tools and 4 base Gmail tools (search, get, send, run). Use gog_gmail_run for advanced settings (filters, delegates, forwarding, sendas, vacation, watch) and email tracking (track).